Skip to main content
GET
/
agents
/
{agentId}
Get Agent
curl --request GET \
  --url https://api.ag.dev/v0.1/agents/{agentId} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "modelStackId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "webhookUrl": "<string>",
  "inputSchema": {},
  "goalPrompt": "<string>",
  "customPlanningInstructions": "<string>",
  "customToolCallInstructions": "<string>",
  "customResultInstructions": "<string>",
  "enableContextCompression": true,
  "tools": [
    {
      "source": "builtin",
      "type": "searchWeb"
    }
  ],
  "resultType": "document",
  "resultSchema": {},
  "isActive": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
agentId
string
required

Agent ID

Response

Agent details

​
id
string
required

Unique identifier for the agent

​
modelStackId
string
required

The model stack used by the agent

​
inputSchema
object
required

JSON schema defining input structure

​
goalPrompt
string
required

The main goal prompt for the agent

​
tools
object[]
required

Available tools for the agent

  • Option 1
  • Option 2
​
resultType
enum<string>
required

Type of result the agent produces

Available options:
document,
json
​
isActive
boolean
required

Whether the agent is active

​
createdAt
string<date-time>
required

Agent creation timestamp

​
updatedAt
string<date-time>
required

Agent last update timestamp

​
name
string | null

Human-readable name for the agent

​
description
string | null

Human-readable description for the agent

​
webhookUrl
string<uri> | null

Webhook URL for run completion notifications

​
customPlanningInstructions
string | null

Custom planning instructions

​
customToolCallInstructions
string | null

Custom tool call instructions

​
customResultInstructions
string | null

Custom result formatting instructions

​
enableContextCompression
boolean

Whether context compression is enabled

​
resultSchema
object | null

JSON schema for result validation (only for json result type)