Create a ticket
Tickets
Create a ticket
Opens a conversation. There is no subject: a ticket is described by its first message.
Supplying requester.external_id asserts that you authenticated this person, so the requester is stored verified. An email address alone is not proof and stores unverified.
Accepts an Idempotency-Key header. A repeat within 24 hours returns the original response rather than opening a second ticket.
POST
Create a ticket
Authorizations
An API credential from Settings → API, sent as Authorization: Bearer mdsk_api_.... Issued per workspace and shown once.
Headers
Any unique string. Replays within 24 hours return the first response.
Body
application/json
Response
The ticket was created.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Available options:
new, open, pending, resolved, closed Available options:
low, normal, high, urgent Available options:
agent, widget, email, api