DeskCrew Tickets API
The Tickets API from DeskCrew — 4 operation(s) for tickets.
The Tickets API from DeskCrew — 4 operation(s) for tickets.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/deskcrew-io:deskcrew-io-tickets-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Deskcrew Io Tickets API
version: 1.0.0
contact:
name: DeskCrew support
url: https://deskcrew.io/board/deskcrew
email: hello@deskcrew.io
description: 'Operations tagged Tickets across 2 of this provider''s published API definitions: openapi.json, deskcrew-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://deskcrew.io
security:
- bearerAuth: []
tags:
- name: Tickets
paths:
/api/v1/tickets:
get:
summary: List tickets
description: Requires the `tickets:read` scope.
operationId: get_api_v1_tickets
security:
- bearerAuth: []
parameters:
- name: status
in: query
required: false
description: active, pending, or closed
schema:
type: string
- name: limit
in: query
required: false
description: Max rows, 1 to 100 (default 25)
schema:
type: string
- name: page
in: query
required: false
description: Page number, 1-based
schema:
type: string
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Tickets
post:
summary: Create a ticket
description: Requires the `tickets:write` scope.
operationId: post_api_v1_tickets
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
description: 'subject: string, required; body: string, required: the customer message; customer_email: string, required; priority: low | normal | high'
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Tickets
servers:
- url: https://deskcrew.io
/api/v1/tickets/{id}:
get:
summary: Get one ticket with its timeline
description: Requires the `tickets:read` scope.
operationId: get_api_v1_tickets__id_
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Tickets
servers:
- url: https://deskcrew.io
/api/v1/tickets/{id}/replies:
post:
summary: Add an internal note or agent reply to a ticket
description: Requires the `tickets:write` scope.
operationId: post_api_v1_tickets__id__replies
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
description: 'body: string, required; internal: boolean, default false'
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Tickets
servers:
- url: https://deskcrew.io
/api/v1/tickets/{id}/reply:
post:
summary: Draft or send a customer-facing reply
description: The external-agent seam. Drafts land in the human approval queue unless the workspace has explicitly enabled sending. Requires the `tickets:reply` scope.
operationId: post_api_v1_tickets__id__reply
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
description: 'body: string, required; send: boolean, default false'
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Tickets
servers:
- url: https://deskcrew.io
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: A workspace API key that starts with dk_, or a signed-in person's session token from the DeskCrew apps.
x-refined-from:
- openapi.json
- deskcrew-io-openapi.json
x-scopes:
- tickets:read
- tickets:write
- tickets:reply
- issues:read
- issues:write
- changelog:read
- changelog:write
- customers:read
- kb:read
- kb:write
- webhooks:manage
- errors:write
- bounties:manage
- bounties:read