Create a new agent

Create a new agent (ChatSettings) with specified tools and MCP servers. Access control: Users can create agents in their personal groups. Company admins can create agents in any group within their company. Sys-admin users can create agents in any group.

POST /api/v3/agents

Create a new agent

cURL

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
}
'

201

{
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "company": {
    "id": 123,
    "name": "<string>",
    "allow_ephemeral_mode": true,
    "is_sharing_enabled": true
  },
  "group": {
    "id": 123,
    "name": "<string>"
  },
  "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,
  "ownership": "<string>",
  "scope_workspaces_by_group": true,
  "scoped_workspace_ids": [
    123
  ],
  "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

application/jsonapplication/x-www-form-urlencodedmultipart/form-data

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 · enum<string> any

• personal - personal
• company - company
• team - team

Available options: personal, company, team

Response

201

application/json

id · integer · required

name · string · required

description · string | null · required

instructions · string | null · required

company · object · required

Show child attributes

group · object · required

Show child attributes

workspaces · object[] · required

Show child attributes

tools · object · required

Show child attributes

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