Skip to main content
POST
Create a new agent

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

name
string
required
company_id
integer
required
description
string | null
instructions
string | null
scope_workspaces_by_group
boolean
default:true
group_id
integer | null
native_tool_ids
string<uuid>[]
mcp_server_ids
string<uuid>[]
scoped_workspace_ids
integer[] | null
ownership
  • personal - personal
  • company - company
  • team - team
Available options:
personal,
company,
team

Response

id
integer
required
name
string
required
description
string | null
required
instructions
string | null
required
company
object
required
group
object
required
workspaces
object[]
required
tools
object
required
is_default
boolean
required
ownership
string
required
scope_workspaces_by_group
boolean
required
scoped_workspace_ids
integer[]
required
is_current_user_favorite
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required