Skip to main content
POST
/
api
/
v3
/
agents
Create a new agent
curl --request POST \
  --url https://paradigm.lighton.ai/api/v3/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "company_id": 123,
  "group_id": 123
}
'
{
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "company": {
    "id": 123,
    "name": "<string>",
    "allow_ephemeral_mode": true,
    "is_sharing_enabled": true
  },
  "group": {
    "name": "<string>",
    "id": 123
  },
  "workspaces": [
    {
      "id": 123,
      "name": "<string>",
      "category": "<string>",
      "file_count": 123,
      "summaries": []
    }
  ],
  "tools": {
    "native": [
      {
        "id": "<string>",
        "name": "<string>",
        "object": "tool"
      }
    ],
    "mcp_servers": [
      {
        "id": "<string>",
        "name": "<string>",
        "object": "mcp_server"
      }
    ]
  },
  "is_default": true,
  "scope_workspaces_by_group": true,
  "is_current_user_favorite": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

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
group_id
integer
required
description
string | null
instructions
string | null
native_tool_ids
string<uuid>[]
mcp_server_ids
string<uuid>[]

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
scope_workspaces_by_group
boolean
required
is_current_user_favorite
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required