Skip to main content
POST
Create AI Agent

Body

application/json

The request body resource

name
string
required

Human-readable name for the AI Agent

Example:

"claude-ops"

groups
string[]

Groups to assign to this AI Agent

Example:

Response

Created

created_at
string

Creation timestamp

created_by
string

Subject of the admin who created this agent

deactivated_at
string

Revocation timestamp

deactivated_by
string

Subject of the admin who revoked this agent

groups
string[]

Groups assigned to this AI Agent

Example:
id
string<uuid>
read-only

Unique identifier

key
string

The generated AI Agent key. This is the only time the full key is shown.

Example:

"hpk_Ab3fX9kL..."

last_used_at
string

Timestamp of last usage

masked_key
string

Masked version of the AI Agent key for identification

Example:

"hpk_1nzb***************************************"

name
string

Human-readable name

Example:

"ai-agent"

org_id
string<uuid>
read-only

Organization ID

status
enum<string>

Current status of the AI Agent

Available options:
active,
revoked