# initdesk API

## Docs

- [Create customer](https://developers.initdesk.com/api-reference/customers/create-customer.md)
- [List customers](https://developers.initdesk.com/api-reference/customers/list-customers.md)
- [Retrieve customer](https://developers.initdesk.com/api-reference/customers/retrieve-customer.md)
- [Update customer](https://developers.initdesk.com/api-reference/customers/update-customer.md)
- [Create article](https://developers.initdesk.com/api-reference/help-center/create-article.md)
- [Create collection](https://developers.initdesk.com/api-reference/help-center/create-collection.md)
- [Delete article](https://developers.initdesk.com/api-reference/help-center/delete-article.md)
- [Delete collection](https://developers.initdesk.com/api-reference/help-center/delete-collection.md)
- [Get portal settings](https://developers.initdesk.com/api-reference/help-center/get-portal-settings.md): Return the organization's support portal settings. Creates a portal record if one does not exist yet.
- [List articles](https://developers.initdesk.com/api-reference/help-center/list-articles.md)
- [List collection tree](https://developers.initdesk.com/api-reference/help-center/list-collection-tree.md): Return collections as a nested tree. Use include_articles to embed articles per collection node.
- [List collections](https://developers.initdesk.com/api-reference/help-center/list-collections.md)
- [Partially update article](https://developers.initdesk.com/api-reference/help-center/partially-update-article.md)
- [Partially update collection](https://developers.initdesk.com/api-reference/help-center/partially-update-collection.md)
- [Replace portal settings](https://developers.initdesk.com/api-reference/help-center/replace-portal-settings.md): Replace all portal settings for the organization (full update).
- [Retrieve article](https://developers.initdesk.com/api-reference/help-center/retrieve-article.md)
- [Retrieve collection](https://developers.initdesk.com/api-reference/help-center/retrieve-collection.md)
- [Search knowledge base articles](https://developers.initdesk.com/api-reference/help-center/search-knowledge-base-articles.md): Search articles by title, excerpt, and markdown content. Results are limited by the limit query parameter.
- [Update article](https://developers.initdesk.com/api-reference/help-center/update-article.md)
- [Update collection](https://developers.initdesk.com/api-reference/help-center/update-collection.md)
- [Update portal settings](https://developers.initdesk.com/api-reference/help-center/update-portal-settings.md): Partially update portal settings for the organization.
- [Retrieve organization](https://developers.initdesk.com/api-reference/organizations/retrieve-organization.md): Retrieve an organization by its ID.
- [Create ticket](https://developers.initdesk.com/api-reference/tickets/create-ticket.md): Create a ticket via API (associate or integration). When CC email routing is enabled, optional `external_recipient_emails` sets only the ticket creation-time external CC list on this create: if the key is omitted or null, the ticket starts with no external CC addresses; if a list is sent (empty or n…
- [Download ticket attachment](https://developers.initdesk.com/api-reference/tickets/download-ticket-attachment.md): Redirects to the attachment file URL in storage (HTTP redirect response).
- [List ticket messages](https://developers.initdesk.com/api-reference/tickets/list-ticket-messages.md): Return messages for a ticket. Results are cached; creating or updating messages invalidates the cache.
- [List ticket statuses](https://developers.initdesk.com/api-reference/tickets/list-ticket-statuses.md): Return all ticket status values with human-readable labels (enum value and description per entry).
- [Reply or create internal note](https://developers.initdesk.com/api-reference/tickets/reply-or-create-internal-note.md): Create a reply or internal note. When CC email routing is enabled, optional `external_recipient_emails` on customer-visible messages sets that message's snapshot only (the ticket row is not updated). Omitted or null copies the last customer-visible message's snapshot, or the ticket's creation-time l…
- [Retrieve ticket](https://developers.initdesk.com/api-reference/tickets/retrieve-ticket.md): Return full ticket details for the given ticket ID. To retrieve its messages (replies and internal notes), use the `messages` endpoint.
- [Search tickets](https://developers.initdesk.com/api-reference/tickets/search-tickets.md): Performs full text & faceted search over tickets. Use `preset_filter` to apply one of the predefined filter sets.
- [Unassign ticket](https://developers.initdesk.com/api-reference/tickets/unassign-ticket.md): Removes the current assignee from the ticket (sets assignee to null) and returns updated ticket details.

## OpenAPI Specs

- [public-api-schema](https://api.initdesk.com/api/public-api-schema.yaml)