Skip to main content
DELETE
/
tickets
/
{ticketId}
Archive ticket
curl --request DELETE \
  --url https://api.routera.io/tickets/{ticketId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "external_id": "<string>",
  "ticket_name": "<string>",
  "pipeline": "<string>",
  "ticket_owner": "jane@example.com",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "archived": true,
  "archived_by": "<string>"
}

​
Endpoint

DELETE https://api.routera.io/tickets/{id}
Route: /tickets/{ticketId}
Authentication: Bearer JWT Path parameter: ticketId — object ID DELETE archives the object. The record is kept and archived is set to an ISO timestamp.

​
Response fields after archive

The 200 response uses default properties plus archived_by:
PropertyDescription
idInternal object ID
ticket_nameCustom or system field (flat on the object)
pipelineCustom or system field (flat on the object)
ticket_ownerAssigned owner email
external_idExternal identifier (nullable)
archivedfalse when active; ISO timestamp when archived
archived_byUser or API client ID who archived the object (only when archived; added automatically)
FieldValue when archived
archivedISO timestamp (no longer false)
archived_byID of the user or API client who archived the object
created_at and updated_at are always included in every response.

​
Response example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "external_id": "ext-001",
  "created_at": "2026-05-01T10:00:00.000Z",
  "updated_at": "2026-05-28T12:00:00.000Z",
  "archived": "2026-05-28T12:00:00.000Z",
  "ticket_name": "Support request",
  "pipeline": "default",
  "ticket_stage": "new",
  "ticket_owner": "jane@example.com",
  "archived_by": "user-uuid"
}

​
Errors

StatusWhen
400Missing ticketId in path
401Missing account context
404Object not found or already archived

Authorizations

​
Authorization
string
header
required

Bearer JWT with valid account context.

Path Parameters

​
ticketId
string
required

Object identifier

Response

Archived object

​
id
string
​
external_id
string | null
​
ticket_name
string | null
​
pipeline
string | null
​
ticket_owner
string | null

Assigned owner email

Example:

"jane@example.com"

​
created_at
string<date-time>
​
updated_at
string<date-time>
​
archived

false when active, or ISO timestamp when archived

​
archived_by
string