# Contracting ## Docs - [Claude Code setup](https://docs.kukkingu.software/ai-tools/claude-code.md): Configure Claude Code for your documentation workflow - [Cursor setup](https://docs.kukkingu.software/ai-tools/cursor.md): Configure Cursor for your documentation workflow - [Windsurf setup](https://docs.kukkingu.software/ai-tools/windsurf.md): Configure Windsurf for your documentation workflow - [Create address](https://docs.kukkingu.software/api-reference/addresses/create-address.md): Creates a new address for the provided contact. - [Delete address](https://docs.kukkingu.software/api-reference/addresses/delete-address.md): Deletes an address by its ID. - [Get address](https://docs.kukkingu.software/api-reference/addresses/get-address.md): Retrieves a single address by its ID. - [List addresses](https://docs.kukkingu.software/api-reference/addresses/list-addresses.md): Retrieves addresses for the authenticated tenant. - [Partially update address](https://docs.kukkingu.software/api-reference/addresses/partially-update-address.md): Partially updates an existing address by its ID. - [Reorder addresses](https://docs.kukkingu.software/api-reference/addresses/reorder-addresses.md): Updates the ordering of addresses within a contact. Addresses not listed keep relative order by creation date. - [Update address](https://docs.kukkingu.software/api-reference/addresses/update-address.md): Updates an existing address by its ID. - [Create billables](https://docs.kukkingu.software/api-reference/billables/create-billables.md): Creates new billables for the given invoice. - [Delete billable](https://docs.kukkingu.software/api-reference/billables/delete-billable.md): Deletes a billable by its ID. - [Get billable](https://docs.kukkingu.software/api-reference/billables/get-billable.md): Retrieves a billable by its ID. - [List billables](https://docs.kukkingu.software/api-reference/billables/list-billables.md): Retrieves billables for the authenticated tenant. - [Partially update billable](https://docs.kukkingu.software/api-reference/billables/partially-update-billable.md): Partially updates an existing billable by its ID. - [Reorder billables](https://docs.kukkingu.software/api-reference/billables/reorder-billables.md): Updates the ordering of billables for the provided invoice. Billables not listed keep relative order by creation date. - [Update billable](https://docs.kukkingu.software/api-reference/billables/update-billable.md): Updates an existing billable by its ID. - [Create client](https://docs.kukkingu.software/api-reference/clients/create-client.md): Creates a new client for the authenticated tenant. - [Delete client](https://docs.kukkingu.software/api-reference/clients/delete-client.md): Deletes a client by its ID. - [Get client](https://docs.kukkingu.software/api-reference/clients/get-client.md): Retrieves a client by its ID. - [List clients](https://docs.kukkingu.software/api-reference/clients/list-clients.md): Retrieves every client for the authenticated tenant. - [Partially update client](https://docs.kukkingu.software/api-reference/clients/partially-update-client.md): Partially updates an existing client by its ID. - [Reorder clients](https://docs.kukkingu.software/api-reference/clients/reorder-clients.md): Updates the ordering of the current tenant's clients. Clients not listed keep relative order by creation date. - [Update client](https://docs.kukkingu.software/api-reference/clients/update-client.md): Updates an existing client by its ID. - [Create contact](https://docs.kukkingu.software/api-reference/contacts/create-contact.md): Creates a new contact for the provided client. - [Delete contact](https://docs.kukkingu.software/api-reference/contacts/delete-contact.md): Deletes a contact by its ID. - [Get contact](https://docs.kukkingu.software/api-reference/contacts/get-contact.md): Retrieves a single contact by its ID. - [List contacts](https://docs.kukkingu.software/api-reference/contacts/list-contacts.md): Retrieves contacts for the authenticated tenant. - [Partially update contact](https://docs.kukkingu.software/api-reference/contacts/partially-update-contact.md): Partially updates an existing contact by its ID. - [Reorder contacts](https://docs.kukkingu.software/api-reference/contacts/reorder-contacts.md): Updates the ordering of contacts within a client. Contacts not listed keep relative order by creation date. - [Update contact](https://docs.kukkingu.software/api-reference/contacts/update-contact.md): Updates an existing contact by its ID. - [Create contract](https://docs.kukkingu.software/api-reference/contracts/create-contract.md): Creates a new contract. - [Delete contract](https://docs.kukkingu.software/api-reference/contracts/delete-contract.md): Deletes a contract by its ID. - [Get contract](https://docs.kukkingu.software/api-reference/contracts/get-contract.md): Retrieves a contract by its ID. - [List contracts](https://docs.kukkingu.software/api-reference/contracts/list-contracts.md): Retrieves every contract currently stored by the service. - [Partially update contract](https://docs.kukkingu.software/api-reference/contracts/partially-update-contract.md): Partially updates an existing contract by its ID. - [Reorder contracts](https://docs.kukkingu.software/api-reference/contracts/reorder-contracts.md): Updates the ordering of the current user's contracts. Contracts not listed keep relative order by creation date. - [Update contract](https://docs.kukkingu.software/api-reference/contracts/update-contract.md): Updates an existing contract by its ID. - [Get generated OpenAPI document](https://docs.kukkingu.software/api-reference/docs/get-generated-openapi-document.md): Returns the static OpenAPI JSON generated during build. - [Create email](https://docs.kukkingu.software/api-reference/emails/create-email.md): Creates a new email for the provided contact. - [Delete email](https://docs.kukkingu.software/api-reference/emails/delete-email.md): Deletes an email by its ID. - [Get email](https://docs.kukkingu.software/api-reference/emails/get-email.md): Retrieves a single email by its ID. - [List emails](https://docs.kukkingu.software/api-reference/emails/list-emails.md): Retrieves emails for the authenticated tenant. - [Partially update email](https://docs.kukkingu.software/api-reference/emails/partially-update-email.md): Partially updates an existing email by its ID. - [Reorder emails](https://docs.kukkingu.software/api-reference/emails/reorder-emails.md): Updates the ordering of emails within a contact. Emails not listed keep relative order by creation date. - [Update email](https://docs.kukkingu.software/api-reference/emails/update-email.md): Updates an existing email by its ID. - [Service health heartbeat](https://docs.kukkingu.software/api-reference/health/service-health-heartbeat.md): Basic health probe that validates the service is running. - [Create invoice](https://docs.kukkingu.software/api-reference/invoices/create-invoice.md): Creates a new invoice for the provided contract. - [Delete invoice](https://docs.kukkingu.software/api-reference/invoices/delete-invoice.md): Deletes an invoice by its ID. - [Finalize an invoice draft](https://docs.kukkingu.software/api-reference/invoices/finalize-an-invoice-draft.md): Finalizes an invoice draft, changing its status to FINALIZED. This action is irreversible. - [Get invoice](https://docs.kukkingu.software/api-reference/invoices/get-invoice.md): Retrieves a single invoice by its ID. - [Get invoice PDF](https://docs.kukkingu.software/api-reference/invoices/get-invoice-pdf.md): Retrieves the PDF document for a specific invoice. - [List invoices](https://docs.kukkingu.software/api-reference/invoices/list-invoices.md): Retrieves invoices for the authenticated tenant. - [Partially update invoice](https://docs.kukkingu.software/api-reference/invoices/partially-update-invoice.md): Applies a partial update to an invoice by its ID. - [Update invoice](https://docs.kukkingu.software/api-reference/invoices/update-invoice.md): Updates an existing invoice by its ID. - [Void an invoice](https://docs.kukkingu.software/api-reference/invoices/void-an-invoice.md): Voids an invoice, changing its status to VOID. This action is irreversible and it prevents the invoice from being changed in any way. - [Create project](https://docs.kukkingu.software/api-reference/projects/create-project.md): Creates a new project for the provided contract. - [Delete project](https://docs.kukkingu.software/api-reference/projects/delete-project.md): Deletes a project by its ID. - [Get project](https://docs.kukkingu.software/api-reference/projects/get-project.md): Retrieves a single project by its ID. - [List projects](https://docs.kukkingu.software/api-reference/projects/list-projects.md): Retrieves projects for the authenticated tenant. - [Partially update project](https://docs.kukkingu.software/api-reference/projects/partially-update-project.md): Partially updates an existing project by its ID. - [Reorder projects](https://docs.kukkingu.software/api-reference/projects/reorder-projects.md): Updates the ordering of projects within a contract. Projects not listed keep relative order by creation date. - [Update project](https://docs.kukkingu.software/api-reference/projects/update-project.md): Updates an existing project by its ID. - [Create tenant](https://docs.kukkingu.software/api-reference/tenants/create-tenant.md): Creates a new tenant. - [Delete tenant](https://docs.kukkingu.software/api-reference/tenants/delete-tenant.md): Deletes a tenant by its ID. - [Get tenant](https://docs.kukkingu.software/api-reference/tenants/get-tenant.md): Retrieves a specific tenant by ID. - [List tenants](https://docs.kukkingu.software/api-reference/tenants/list-tenants.md): Retrieves every tenant associated to the user. - [Partially update tenant](https://docs.kukkingu.software/api-reference/tenants/partially-update-tenant.md): Partially updates an existing tenant by its ID. - [Update tenant](https://docs.kukkingu.software/api-reference/tenants/update-tenant.md): Updates an existing tenant by its ID. - [Create time entry](https://docs.kukkingu.software/api-reference/time-entries/create-time-entry.md): Creates a new time entry for the authenticated tenant. - [Delete time entry](https://docs.kukkingu.software/api-reference/time-entries/delete-time-entry.md): Deletes a time entry by its ID. - [Get time entry](https://docs.kukkingu.software/api-reference/time-entries/get-time-entry.md): Retrieves a single time entry by its ID. - [List time entries](https://docs.kukkingu.software/api-reference/time-entries/list-time-entries.md): Retrieves time entries for the authenticated tenant. - [Partially update time entry](https://docs.kukkingu.software/api-reference/time-entries/partially-update-time-entry.md): Partially updates a time entry by its ID. - [Update time entry](https://docs.kukkingu.software/api-reference/time-entries/update-time-entry.md): Replaces a time entry by its ID. - [Delete user setting](https://docs.kukkingu.software/api-reference/users/delete-user-setting.md): Deletes a user setting by key for the authenticated user. - [Get current user](https://docs.kukkingu.software/api-reference/users/get-current-user.md): Displays the authenticated user's profile information. - [Get user setting](https://docs.kukkingu.software/api-reference/users/get-user-setting.md): Retrieves a single user setting by key for the authenticated user. - [Get user settings](https://docs.kukkingu.software/api-reference/users/get-user-settings.md): Displays the authenticated user's settings. - [Set user setting](https://docs.kukkingu.software/api-reference/users/set-user-setting.md): Creates or updates a user setting for the authenticated user, identified by key. - [Development](https://docs.kukkingu.software/development.md): Preview changes locally to update your docs - [Code blocks](https://docs.kukkingu.software/essentials/code.md): Display inline code and code blocks - [Images and embeds](https://docs.kukkingu.software/essentials/images.md): Add image, video, and other HTML elements - [Markdown syntax](https://docs.kukkingu.software/essentials/markdown.md): Text, title, and styling in standard markdown - [Navigation](https://docs.kukkingu.software/essentials/navigation.md): The navigation field in docs.json defines the pages that go in the navigation menu - [Reusable snippets](https://docs.kukkingu.software/essentials/reusable-snippets.md): Reusable, custom snippets to keep content in sync - [Global Settings](https://docs.kukkingu.software/essentials/settings.md): Mintlify gives you complete control over the look and feel of your documentation using the docs.json file - [Introduction](https://docs.kukkingu.software/index.md): Welcome to the new home for your documentation - [Quickstart](https://docs.kukkingu.software/quickstart.md): Start building awesome documentation in minutes - [Client setup](https://docs.kukkingu.software/sdk/client-setup.md): Install the SDK and create a client with token, tenant context, and optional fetch implementation. - [Contracting SDK overview](https://docs.kukkingu.software/sdk/introduction.md): Use the TypeScript SDK to call Contracting API endpoints with typed methods and request validation. - [Request options and errors](https://docs.kukkingu.software/sdk/request-options-and-errors.md): Control auth, tenant context, headers, query, cancellation, and error handling. - [Resources and examples](https://docs.kukkingu.software/sdk/resources-and-examples.md): Reference for every SDK method, including CRUD, ordering endpoints, invoice lifecycle actions, and common workflows. ## OpenAPI Specs - [docs](https://api.contracting.kukkingu.software/api/v1/docs.json) - [openapi](https://docs.kukkingu.software/api-reference/openapi.json) ## Optional - [Documentation](https://mintlify.com/docs) - [Blog](https://mintlify.com/blog)