# Nerds Platform Docs

## Docs

- [Claude Code setup](https://docs.developers.nerds.nl/ai-tools/claude-code.md): Configure Claude Code for your documentation workflow
- [Cursor setup](https://docs.developers.nerds.nl/ai-tools/cursor.md): Configure Cursor for your documentation workflow
- [Windsurf setup](https://docs.developers.nerds.nl/ai-tools/windsurf.md): Configure Windsurf for your documentation workflow
- [Create a comment on a ticket](https://docs.developers.nerds.nl/api-reference/comments/create-a-comment-on-a-ticket.md): Adds a new comment to the ticket identified by `id`. If `id` is provided in the body and a comment with that ID already exists, it is updated (idempotent).
- [Create or update a contact](https://docs.developers.nerds.nl/api-reference/contacts/create-or-update-a-contact.md): Creates a new contact or updates an existing one identified by `id`.
- [Get a contact by ID](https://docs.developers.nerds.nl/api-reference/contacts/get-a-contact-by-id.md)
- [Create or update an organization](https://docs.developers.nerds.nl/api-reference/organizations/create-or-update-an-organization.md): Creates a new organization or updates an existing one identified by `id`.
- [Get an organization by ID](https://docs.developers.nerds.nl/api-reference/organizations/get-an-organization-by-id.md)
- [Create or update a partner status variant](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-partner-status-variant.md): Upserts a partner-specific status variant. If a status with the same `id` already exists for this partner, it will be updated. Otherwise a new status is created.
- [Create or update a ticket category](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-ticket-category.md)
- [Create or update a ticket group](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-ticket-group.md)
- [Create or update a ticket priority](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-ticket-priority.md)
- [Create or update a ticket subcategory](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-ticket-subcategory.md)
- [Create or update a ticket type](https://docs.developers.nerds.nl/api-reference/references/create-or-update-a-ticket-type.md)
- [Create or update an external agent](https://docs.developers.nerds.nl/api-reference/references/create-or-update-an-external-agent.md)
- [List external agents](https://docs.developers.nerds.nl/api-reference/references/list-external-agents.md): Returns all active agents for the partner, ordered by name.
- [List internal default status categories](https://docs.developers.nerds.nl/api-reference/references/list-internal-default-status-categories.md): Returns the 6 internal default status categories: New, Open, Hold, Pending, Solved, Closed. Partners use this to discover which categories they can map their status variants to.
- [List partner status variants](https://docs.developers.nerds.nl/api-reference/references/list-partner-status-variants.md): Returns all status variants for the authenticated partner, each with its mapped internal category. Ordered by category sort_order.
- [List ticket categories](https://docs.developers.nerds.nl/api-reference/references/list-ticket-categories.md): Returns all active categories for the partner with their parent type_id.
- [List ticket groups](https://docs.developers.nerds.nl/api-reference/references/list-ticket-groups.md): Returns all active groups for the partner, ordered by sort_order.
- [List ticket priorities](https://docs.developers.nerds.nl/api-reference/references/list-ticket-priorities.md): Returns all active priorities for the partner, ordered by sort_order.
- [List ticket subcategories](https://docs.developers.nerds.nl/api-reference/references/list-ticket-subcategories.md): Returns all active subcategories for the partner with their parent category_id.
- [List ticket types](https://docs.developers.nerds.nl/api-reference/references/list-ticket-types.md): Returns all active types for the partner, ordered by sort_order.
- [Create or update a task](https://docs.developers.nerds.nl/api-reference/tasks/create-or-update-a-task.md): Creates a new task or updates an existing one if a duplicate is detected (same phone + type + status=open for the partner).
- [Create or update a ticket](https://docs.developers.nerds.nl/api-reference/tickets/create-or-update-a-ticket.md): Creates a new ticket or updates an existing one identified by `id` (the external ticket ID from the source system). The partner is derived from the API key.
- [Get a ticket by ID](https://docs.developers.nerds.nl/api-reference/tickets/get-a-ticket-by-id.md)
- [Development](https://docs.developers.nerds.nl/development.md): Preview changes locally to update your docs
- [Code blocks](https://docs.developers.nerds.nl/essentials/code.md): Display inline code and code blocks
- [Images and embeds](https://docs.developers.nerds.nl/essentials/images.md): Add image, video, and other HTML elements
- [Markdown syntax](https://docs.developers.nerds.nl/essentials/markdown.md): Text, title, and styling in standard markdown
- [Navigation](https://docs.developers.nerds.nl/essentials/navigation.md): The navigation field in docs.json defines the pages that go in the navigation menu
- [Reusable snippets](https://docs.developers.nerds.nl/essentials/reusable-snippets.md): Reusable, custom snippets to keep content in sync
- [Global Settings](https://docs.developers.nerds.nl/essentials/settings.md): Mintlify gives you complete control over the look and feel of your documentation using the docs.json file
- [Introduction](https://docs.developers.nerds.nl/index.md): Welcome to the new home for your documentation
- [Quickstart](https://docs.developers.nerds.nl/quickstart.md): Start building awesome documentation in minutes

## OpenAPI Specs

- [openapi](https://docs.developers.nerds.nl/openapi.yaml)

## Optional

- [Documentation](https://mintlify.com/docs)
- [Blog](https://mintlify.com/blog)