List available agent types

Returns the enabled first-party agents the deep-agent runtime can run. Each item's `agentType` is the value to pass as StartAgentRunParams.agentType. Use this to discover what's available before starting a run.

GET /v1/agent-runs/agents

Authentication

API Key (header: Authorization)

Responses

200 OK

application/json

code integer

data object

agents object[]

Array of:

agentType string

AgentType is the registry key passed back as StartAgentRunParams.AgentType.

description string

serves boolean

Serves is true when the agent produces a browser-openable artifact (a report or app) at the run's served URL.

skills string[]

Array of:

title string

message string

requestId string

curl -X GET 'https://api.example.com/v1/agent-runs/agents' \  -H 'Authorization: Bearer YOUR_API_TOKEN'

const response = await fetch('https://api.example.com/v1/agent-runs/agents', {  method: 'GET',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN"  }});const data = await response.json();console.log(data);

import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://api.example.com/v1/agent-runs/agents', headers=headers)print(response.json())

package mainimport (	"fmt"	"io"	"net/http")func main() {	req, _ := http.NewRequest("GET", "https://api.example.com/v1/agent-runs/agents", nil)	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")	resp, _ := http.DefaultClient.Do(req)	defer resp.Body.Close()	result, _ := io.ReadAll(resp.Body)	fmt.Println(string(result))}

200 Response

{  "code": 200,  "data": {    "agents": [      {        "agentType": "<string>",        "description": "<string>",        "serves": true,        "skills": [          "<string>"        ],        "title": "<string>"      }    ]  },  "message": "success",  "requestId": "abc-123"}

GET /v1/agent-runs/agents

Base URL

Bearer Token

Response

Was this page helpful?

Previous Start an agent run

Next List a conversation's app artifacts