Create a ticket - Thena AI

Introduction

API Reference
Platform
- Platform APIs
- Login & sign up
- Organizations
- SLA duration
- Users
- Teams
- Tickets
  - Core operations
  - Assignment & escalation
  - Relationships
  - Comments & attachments
  - Time tracking
  - Status management
  - Type management
  - Priority management
  - Tag management
  - Ticket tags
  - Other operations
- Comments & reactions
- Custom fields
- Forms
- Draft tickets
- Accounts & contacts
- Custom objects
- Workflows
- SLA
- Storage
- Notifications

POST

tickets

curl --request POST \
  --url https://platform.thena.ai/v1/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-org-id: <api-key>' \
  --data '{
  "assignedAgentId": "<string>",
  "assignedAgentEmail": "<string>",
  "description": "<string>",
  "dueDate": "2023-11-07T05:31:56Z",
  "submitterEmail": "<string>",
  "statusId": "<string>",
  "statusName": "<string>",
  "priorityId": "<string>",
  "priorityName": "<string>",
  "metadata": {},
  "typeId": "<string>",
  "isPrivate": true,
  "source": "<string>",
  "aiGeneratedTitle": "<string>",
  "aiGeneratedSummary": "<string>",
  "attachmentUrls": [
    "<string>"
  ],
  "customFieldValues": [
    {}
  ],
  "title": "<string>",
  "requestorEmail": "<string>",
  "accountId": "<string>",
  "performRouting": true,
  "teamId": "<string>",
  "formId": "<string>"
}'

{
  "status": true,
  "message": "Success",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "data": {
    "id": "<string>",
    "title": "<string>",
    "ticketId": 123,
    "description": "<string>",
    "accountId": "<string>",
    "status": "<string>",
    "statusId": "<string>",
    "priority": "<string>",
    "priorityId": "<string>",
    "storyPoints": 123,
    "account": "<string>",
    "teamId": "<string>",
    "teamName": "<string>",
    "isPrivate": true,
    "typeId": "<string>",
    "type": "<string>",
    "assignedAgent": "<string>",
    "assignedAgentId": "<string>",
    "assignedAgentEmail": "<string>",
    "requestorEmail": "<string>",
    "customerContactId": "<string>",
    "customerContactFirstName": "<string>",
    "customerContactLastName": "<string>",
    "customerContactEmail": "<string>",
    "submitterEmail": "<string>",
    "customFieldValues": [
      "<string>"
    ],
    "deletedAt": "<string>",
    "archivedAt": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "formId": "<string>",
    "aiGeneratedTitle": "<string>",
    "aiGeneratedSummary": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Enter JWT bearer token

x-org-id

string

header

required

Enter organization ID

Body

application/json

title

string

required

The title of the ticket

requestorEmail

string

required

The email of the requestor

teamId

string

required

The ID of the team

assignedAgentId

string

The ID of the assigned agent

assignedAgentEmail

string

The email of the assigned agent

description

string

The description of the ticket

dueDate

string

The due date of the ticket

submitterEmail

string

The email of the submitter

statusId

string

The ID of the status, status id if provided is used over status name

statusName

string

The name of the status to match against

priorityId

string

The ID of the priority, priority id if provided is used over priority name

priorityName

string

The name of the priority to match against

metadata

object

The metadata of the ticket

typeId

string

The ID of the type

isPrivate

boolean

Whether the ticket is private

source

string

The source of the ticket

aiGeneratedTitle

string

The AI generated title of the ticket

aiGeneratedSummary

string

The AI generated summary of the ticket

attachmentUrls

string[]

The attachment URLs

customFieldValues

object[]

The custom field values

accountId

string

The ID of the account

performRouting

boolean

Whether to perform routing

formId

string

The ID of the form

Response

201

application/json

Operation successful

status

boolean

default:true

required

The status of the response

message

string

default:Success

required

The message of the response

timestamp

string

default:2024-01-01T00:00:00.000Z

required

The timestamp of the response

data

object

required

The response for create/update/delete ticket operations

data.id

string

required

The unique identifier of the ticket

data.title

string

required

The title of the ticket

data.ticketId

number

required

The ticket ID of the ticket

data.description

string

required

The description of the ticket

data.accountId

string

required

The account ID of the ticket

data.status

string

required

The status of the ticket

data.statusId

string

required

The status ID of the ticket

data.priority

string

required

The priority of the ticket

data.priorityId

string

required

The priority ID of the ticket

data.storyPoints

number

required

The story points of the ticket

data.account

string

required

The account of the ticket

data.teamId

string

required

The team ID of the ticket

data.teamName

string

required

The name of the team of the ticket

data.isPrivate

boolean

required

Whether the ticket is private

data.typeId

string

required

The type ID of the ticket

data.type

string

required

The name of the type of the ticket

data.assignedAgent

string

required

The assigned agent of the ticket

data.assignedAgentId

string

required

The assigned agent ID of the ticket

data.assignedAgentEmail

string

required

The assigned agent email of the ticket

data.requestorEmail

string

required

The requestor email of the ticket

data.customerContactId

string

required

The customer contact ID of the ticket

data.customerContactFirstName

string

required

The customer contact first name of the ticket

data.customerContactLastName

string

required

The customer contact last name of the ticket

data.customerContactEmail

string

required

The customer contact email of the ticket

data.submitterEmail

string

required

The submitter email of the ticket

data.customFieldValues

string[]

required

The custom field values

data.deletedAt

string

required

The deleted at date of the ticket

data.archivedAt

string

required

The archived at date of the ticket

data.createdAt

string

required

The created at date of the ticket

data.updatedAt

string

required

The updated at date of the ticket

data.formId

string

required

The form ID of the ticket

data.aiGeneratedTitle

string

required

The AI generated title of the ticket

data.aiGeneratedSummary

string

required

The AI generated summary of the ticket

Get all tickets

Create tickets in bulk

curl --request POST \
  --url https://platform.thena.ai/v1/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-org-id: <api-key>' \
  --data '{
  "assignedAgentId": "<string>",
  "assignedAgentEmail": "<string>",
  "description": "<string>",
  "dueDate": "2023-11-07T05:31:56Z",
  "submitterEmail": "<string>",
  "statusId": "<string>",
  "statusName": "<string>",
  "priorityId": "<string>",
  "priorityName": "<string>",
  "metadata": {},
  "typeId": "<string>",
  "isPrivate": true,
  "source": "<string>",
  "aiGeneratedTitle": "<string>",
  "aiGeneratedSummary": "<string>",
  "attachmentUrls": [
    "<string>"
  ],
  "customFieldValues": [
    {}
  ],
  "title": "<string>",
  "requestorEmail": "<string>",
  "accountId": "<string>",
  "performRouting": true,
  "teamId": "<string>",
  "formId": "<string>"
}'

{
  "status": true,
  "message": "Success",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "data": {
    "id": "<string>",
    "title": "<string>",
    "ticketId": 123,
    "description": "<string>",
    "accountId": "<string>",
    "status": "<string>",
    "statusId": "<string>",
    "priority": "<string>",
    "priorityId": "<string>",
    "storyPoints": 123,
    "account": "<string>",
    "teamId": "<string>",
    "teamName": "<string>",
    "isPrivate": true,
    "typeId": "<string>",
    "type": "<string>",
    "assignedAgent": "<string>",
    "assignedAgentId": "<string>",
    "assignedAgentEmail": "<string>",
    "requestorEmail": "<string>",
    "customerContactId": "<string>",
    "customerContactFirstName": "<string>",
    "customerContactLastName": "<string>",
    "customerContactEmail": "<string>",
    "submitterEmail": "<string>",
    "customFieldValues": [
      "<string>"
    ],
    "deletedAt": "<string>",
    "archivedAt": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "formId": "<string>",
    "aiGeneratedTitle": "<string>",
    "aiGeneratedSummary": "<string>"
  }
}