Skip to main content
GET
/
v2.0
/
aiagents
/
{aiAgentId}
/
jobs
Get AI Agent Jobs and their Tools
curl --request GET \
  --url https://api-trial.cognigy.ai/new/v2.0/aiagents/{aiAgentId}/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <api-key>'
[
  {
    "_id": "<string>",
    "referenceId": "<string>",
    "type": "aiAgentJob",
    "label": "<string>",
    "comment": "<string>",
    "commentColor": "<string>",
    "analyticsLabel": "<string>",
    "isDisabled": true,
    "isEntryPoint": true,
    "extension": "<string>",
    "config": {},
    "tools": [
      {
        "_id": "<string>",
        "referenceId": "<string>",
        "type": "<string>",
        "label": "<string>",
        "comment": "<string>",
        "commentColor": "<string>",
        "analyticsLabel": "<string>",
        "isDisabled": true,
        "isEntryPoint": true,
        "extension": "<string>",
        "config": {}
      }
    ]
  }
]

Authorizations

X-API-Key
string
header
required

Supply the API Key in the HTTP-Header

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

api_key
string
query
required

Supply the API Key in the Url-Query

Headers

Accept
enum<string>

The default media type is application/hal+json. Use application/json for pure data results.

Available options:
application/json,
application/hal+json,
application/xml,
text/xml,
text/csv

Path Parameters

aiAgentId
string
required

The Id of the Ai Agent

Required string length: 24

Response

Returns an array of job nodes, each with a tools array.

_id
string
referenceId
string
type
string
Example:

"aiAgentJob"

label
string
comment
string
commentColor
string
analyticsLabel
string | null
isDisabled
boolean
isEntryPoint
boolean
extension
string
config
object

Job node configuration (content varies by implementation)

tools
object[]
I