Add a note to a ticket
A note your team sees on the ticket; the customer does not. Optionally moves the ticket's status.
A note your team sees on the ticket; the customer does not. Optionally moves the ticket's status.
X-API-Key<token>Create in the console: Settings → API & webhooks.
ticket_id*Ticket IdTicket id.
Idempotency-Key?stringAny unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.
length <= 255application/json- body
A private team note, never sent to the customer; a note may be just attachments.
attachmentIds?array<string>Files already uploaded to the ticket (console only).
items <= 5note?NoteNote text, visible to your team only.
length <= 8000""status?|Also move the ticket to this status: open, in_progress, waiting_on_customer, resolved or closed.
version?|The version you last read; if the ticket changed since, the request fails with 409. Leave out to skip.
OK
application/json- response
activities*array<>Only the activities this request added.
changed*array<string>Fields that changed (activities when a note or reply was added).
success*SuccessAlways true on a 2xx response.
ticket*The ticket after the change.
[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/tickets/string/activities' \ -H 'Content-Type: application/json' \ -d '{ "note": "Courier confirmed the parcel is at the local hub; asked them to redeliver tomorrow.", "status": "waiting_on_customer", "version": 2}'{ "activities": [ { "activityType": "status_change", "actorName": "Priya Nair", "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f", "createdAt": "2026-01-15T11:20:00+00:00", "id": "5f6a7b8c-9d0e-4f1a-9b2c-4d5e6f7a8b9d", "payload": { "from": "in_progress", "source": "console", "to": "waiting_on_customer" }, "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90" }, { "activityType": "comment", "actorName": "Priya Nair", "actorUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f", "createdAt": "2026-01-15T11:20:00+00:00", "id": "3d4e5f6a-7b8c-4d9e-9f0a-2b3c4d5e6f7a", "payload": { "note": "Courier confirmed the parcel is at the local hub; asked them to redeliver tomorrow." }, "ticketId": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90" } ], "changed": [ "status", "activities" ], "success": true, "ticket": { "activityCount": 5, "assignedToUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f", "assigneeEmail": "[email protected]", "assigneeName": "Priya Nair", "assigneeNames": [ "Priya Nair" ], "assignees": [ { "assignedAt": "2026-01-15T09:30:02+00:00", "email": "[email protected]", "name": "Priya Nair", "userId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f" } ], "canEdit": true, "canManageAssignees": true, "canReopenClosed": false, "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56", "categoryName": "Delivery", "createdAt": "2026-01-15T09:30:00+00:00", "createdByUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f", "description": "Customer says the parcel was marked delivered but never arrived.", "dueAt": "2026-01-16T09:30:00+00:00", "id": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90", "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8", "leadName": "Asha Verma", "leadPhone": "+919812345678", "merchantId": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a", "overdue": false, "priority": "high", "ref": "T-5F0C9A3E", "sla": { "firstResponse": { "dueAt": "2026-01-15T13:30:00+00:00", "state": "ok", "warnAt": "2026-01-15T12:30:00+00:00" }, "paused": false, "resolution": { "dueAt": "2026-01-16T09:30:00+00:00", "state": "ok", "warnAt": "2026-01-16T05:30:00+00:00" } }, "source": "manual", "status": "waiting_on_customer", "subject": "Order #1042 not delivered", "tags": [ "order-1042" ], "teamId": "e7a1c3d5-9b2f-4d68-8a0c-2e4f6a8b0c1d", "teamName": "Customer care", "type": "support", "updatedAt": "2026-01-15T11:20:00+00:00", "version": 3 }}List SIP trunks GET
Your own SIP providers connected to the calling gateway, the numbers on each, and the gateway address to give your provider. Passwords are never returned.
Create a ticket POST
Opens a ticket for `leadId` (or the lead behind `waConversationId`). Category and source decide its team; the team's rules may assign it automatically.