Skip to main content
GET
/
agents
/
{id}
Get Agent by ID
curl --request GET \
  --url https://core.ravenna.ai/api/agents/{id} \
  --header 'x-ravenna-api-token: <api-key>'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "imageUrl": "<string>",
  "workspaceId": "<string>",
  "personalityId": "<string>",
  "enabled": true,
  "respondOnMessage": "<string>",
  "respondOnMention": true,
  "autoClassify": true,
  "autoTag": true,
  "negativeFeedbackAutoCreate": true,
  "availableInDM": true,
  "workspace": {
    "id": "<string>",
    "slug": "<string>",
    "name": "<string>"
  },
  "personality": {
    "id": "<string>",
    "workspaceId": "<string>",
    "persona": "<string>",
    "tone": "<string>",
    "emoji": "<string>",
    "length": "<string>",
    "greeting": "<string>",
    "branding": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "slackChannels": [
    {
      "id": "<string>",
      "channelName": "<string>"
    }
  ],
  "queues": [
    {
      "id": "<string>",
      "name": "<string>",
      "prefix": "<string>",
      "emoji": "<string>",
      "system": true,
      "requestTypes": [
        {
          "id": "<string>",
          "name": "<string>",
          "emoji": "<string>",
          "color": "<string>",
          "description": "<string>",
          "icon": "<string>"
        }
      ],
      "kBs": [
        {
          "id": "<string>",
          "name": "<string>",
          "system": true,
          "lastSyncTS": 123,
          "global": true,
          "_count": {
            "kBDocuments": 123
          }
        }
      ]
    }
  ],
  "kBs": [
    {
      "id": "<string>",
      "name": "<string>",
      "system": true,
      "lastSyncTS": 123,
      "global": true,
      "_count": {
        "kBDocuments": 123
      }
    }
  ],
  "requestTypes": [
    {
      "id": "<string>",
      "name": "<string>",
      "emoji": "<string>",
      "color": "<string>",
      "description": "<string>",
      "icon": "<string>",
      "aiExamples": "<string>",
      "customFields": [
        {
          "id": "<string>",
          "order": 123,
          "private": true,
          "required": true,
          "ticketField": "TITLE",
          "requestTypeId": "<string>",
          "customFieldId": "<string>",
          "customField": {
            "id": "<string>",
            "workspaceId": "<string>",
            "key": "<string>",
            "label": "<string>",
            "description": "<string>",
            "required": true,
            "system": true,
            "type": "TEXT",
            "config": "<any>",
            "options": [
              "<any>"
            ],
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "_count": {
              "requestTypeCustomField": 123
            }
          },
          "parentId": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>"
        }
      ]
    }
  ],
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "deletedAt": "<string>"
}

Authorizations

​
x-ravenna-api-token
string
header
required

Path Parameters

​
id
string
required

Response

Successful response

​
id
string
required
​
name
string
required
​
description
string | null
required
​
imageUrl
string | null
required
​
workspaceId
string
required
​
personalityId
string | null
required
​
enabled
boolean
required
​
respondOnMessage
string
required
​
respondOnMention
boolean
required
​
autoClassify
boolean
required
​
autoTag
boolean
required
​
negativeFeedbackAutoCreate
boolean
required
​
availableInDM
boolean
required
​
workspace
object
required
​
personality
object | null
required
​
slackChannels
object[]
required
​
queues
object[]
required
​
kBs
object[]
required
​
requestTypes
object[]
required
​
createdAt
string
required
​
updatedAt
string
required
​
deletedAt
string | null
required
⌘I