Inspect

Create agent

Create a custom agent owned by the user associated with the API key. Slack app, avatar, and contributor settings are not managed by this endpoint.

Base URL
POST
/api/public/v1/agents

Create a custom agent owned by the user associated with the API key. Slack app, avatar, and contributor settings are not managed by this endpoint.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key authentication. Use your API key as the bearer token.

Request Body

application/json
  1. body
name*string

Display name of the agent. Leading and trailing whitespace is trimmed.

Length1 <= length <= 100
description?string

Description of what this agent does

Default""
prompt?|

System prompt, or null to clear it

Lengthlength <= 100000
Defaultnull
model?|

Preferred model, or null to use the default. Any string up to 200 characters is stored; it is not checked against the model list.

Lengthlength <= 200
Defaultnull
skills?array<>|

Configured skill names, or null for no explicit skill list

Defaultnull
capabilities?|

Capability overrides, or null to restore defaults

Defaultnull
prompt_context_mode?Agents.PromptContextMode

Whether the custom prompt appends to or replaces the base system prompt

Default"append"
Value in"append""replace"
repositories?array<>|

Workspace allowlist containing configured workspace IDs; null means unrestricted

Defaultnull
repo_hint?|

Optional default repository hint

Lengthlength <= 500
Defaultnull

Response Body

Custom agent created

application/json
  1. response
data*

Full agent configuration for a single ID. Includes fields not present on the list-agents response.

Example Request
curl -X POST 'https://your-org.inspect.com/api/public/v1/agents' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "data": {    "prompt": "string",    "created_by": "string",    "skills": [      "string"    ],    "capabilities": {      "edit": true,      "git_write": true,      "browser": true,      "user_skills": true,      "repo_skills": true,      "datadog": true,      "customer_data_access": true,      "notion": true,      "inspect_sessions": true,      "web_search": true,      "artifacts": true,      "tools": {},      "linear": true,      "feature_flags": true,      "zendesk": true,      "sentry": true,      "deepwiki": true    },    "prompt_context_mode": "append",    "repositories": [      "string"    ],    "repo_hint": "string",    "id": "string",    "name": "string",    "description": "string",    "model": "string",    "is_builtin": true,    "created_at": "2019-08-24T14:15:22Z"  }}