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>",
    "persona": "<string>",
    "tone": "<string>",
    "emoji": "<string>",
    "length": "<string>",
    "greeting": "<string>",
    "branding": "<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>",
      "lastSyncTS": 123,
      "global": true,
      "_count": {
        "kBDocuments": 123
      }
    }
  ],
  "requestTypes": [
    {
      "id": "<string>",
      "name": "<string>",
      "emoji": "<string>",
      "color": "<string>",
      "description": "<string>",
      "icon": "<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