Create an agent - Matrices

curl --request POST \
  --url https://api.matrices.com/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "identity": "svc:researcher",
  "name": "Researcher",
  "profile": {
    "models": [
      "openai/gpt-5.4"
    ],
    "systemPrompt": "Research the user's question carefully."
  }
}
EOF

{
  "agent": {
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "profileId": "<string>",
    "tags": [
      "<string>"
    ],
    "workspaceId": "<string>",
    "avatar": "<string>",
    "budget": {
      "limit": 1,
      "window": "24h"
    },
    "description": "<string>",
    "identity": "<string>",
    "name": "<string>"
  }
}

{
  "operation": {
    "action": "<string>",
    "agentId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "expiresAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "state": "pending",
    "resolvedAt": "2023-11-07T05:31:56Z",
    "resolvedBy": {
      "id": "<string>",
      "type": "user",
      "identity": "<string>",
      "origin": {
        "provider": "slack",
        "senderId": "<string>",
        "tenantId": "<string>",
        "channelId": "<string>",
        "messageId": "<string>",
        "threadId": "<string>"
      }
    },
    "result": {
      "status": 349,
      "body": "<unknown>"
    }
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

POST

/

v1

/

agents

curl --request POST \
  --url https://api.matrices.com/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "identity": "svc:researcher",
  "name": "Researcher",
  "profile": {
    "models": [
      "openai/gpt-5.4"
    ],
    "systemPrompt": "Research the user's question carefully."
  }
}
EOF

{
  "agent": {
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "profileId": "<string>",
    "tags": [
      "<string>"
    ],
    "workspaceId": "<string>",
    "avatar": "<string>",
    "budget": {
      "limit": 1,
      "window": "24h"
    },
    "description": "<string>",
    "identity": "<string>",
    "name": "<string>"
  }
}

{
  "operation": {
    "action": "<string>",
    "agentId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "expiresAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "state": "pending",
    "resolvedAt": "2023-11-07T05:31:56Z",
    "resolvedBy": {
      "id": "<string>",
      "type": "user",
      "identity": "<string>",
      "origin": {
        "provider": "slack",
        "senderId": "<string>",
        "tenantId": "<string>",
        "channelId": "<string>",
        "messageId": "<string>",
        "threadId": "<string>"
      }
    },
    "result": {
      "status": 349,
      "body": "<unknown>"
    }
  }
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "attemptsRemaining": 123,
  "code": "<string>",
  "retryAfterSeconds": 123
}

Authorizations

Authorization

string

header

required

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

Body

application/json

Option 1
Option 2
Option 3
Option 4

identity

string

required

Provenance identity. Surrounding whitespace is trimmed on input; values may contain at most 512 UTF-8 bytes and no Unicode control characters.

profileId

string

required

Minimum string length: 1

Pattern: \S

avatar

string

Slack emoji shortcode such as :fox_face:, or an https image URL. Agent-authored writes accept only the emoji form. Empty clears.

Maximum string length: 2048

Pattern: ^(?:|:[a-z0-9_+'-]{1,64}:|https://\S+)$

budget

object

Show child attributes

description

string

name

string

profile

object

Show child attributes

tags

string[]

Maximum array length: 32

Response

Created agent.

agent

object

required

Show child attributes