Skip to main content
GET
/
v1
/
agents
/
{agentId}
Get an Agent
curl --request GET \
  --url https://api.browserbase.com/v1/agents/{agentId} \
  --header 'X-BB-API-Key: <api-key>'
{
  "agentId": "<string>",
  "name": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "systemPrompt": "<string>",
  "resultSchema": {}
}

Authorizations

​
X-BB-API-Key
string
header
required

Your Browserbase API Key.

Path Parameters

​
agentId
string
required

The agent ID.

Response

200 - application/json

The agent.

A reusable agent. Referenced by agentId to apply a system prompt to every run that uses the agent.

​
agentId
string
required

Unique identifier for the agent. Use this value as agentId when creating an agent run.

​
name
string
required

Human-readable name for the agent. Used to identify the agent in the dashboard and API responses.

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
systemPrompt
string

System prompt applied to every run that uses this agent.

​
resultSchema
object

JSON Schema that runs referencing this agent will aim to conform their result to. Can be overridden per run by passing resultSchema on the run request.