---
title: "Create Agent Session"
method: POST
path: "/ai/agent_sessions"
tags: ["AI"]
---

# Create Agent Session

`POST /ai/agent_sessions`

## Request body

- CreateAgentSessionRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` CreateAgentSessionAttributes, required
    - `agentName` string, required
    - `input` object, required

## Response `201`

Created

- CreateAgentSessionResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` AgentSession, required
    - `attributes` AgentSessionAttributes, required
      - `agentName` string, required
      - `createdAt` string, date-time, required
      - `initialTurn` AgentTurn
        - `attributes` AgentTurnAttributes, required
          - `createdAt` string, date-time, required
          - `error` AgentTurnError
            - `code` string, required
            - `message` string, required
          - `finishReason` string
          - `finishedAt` string, date-time
          - `knowledgeCitations` AgentTurnKnowledgeCitation[]
            - `attributes` AgentTurnKnowledgeCitationAttributes, required
              - …
            - `id` string, required
          - `parentTurnId` string
          - `startedAt` string, date-time
          - `state` SessionStateRawMessage
            - `artifacts` Artifact[]
              - …
            - `custom` unknown
            - `messages` Message[]
              - …
            - `sessionId` string
          - `status` string, required
          - `updatedAt` string, date-time, required
        - `id` string, required
      - `latestTurn` AgentTurn
        - `attributes` AgentTurnAttributes, required
          - `createdAt` string, date-time, required
          - `error` AgentTurnError
            - `code` string, required
            - `message` string, required
          - `finishReason` string
          - `finishedAt` string, date-time
          - `knowledgeCitations` AgentTurnKnowledgeCitation[]
            - `attributes` AgentTurnKnowledgeCitationAttributes, required
              - …
            - `id` string, required
          - `parentTurnId` string
          - `startedAt` string, date-time
          - `state` SessionStateRawMessage
            - `artifacts` Artifact[]
              - …
            - `custom` unknown
            - `messages` Message[]
              - …
            - `sessionId` string
          - `status` string, required
          - `updatedAt` string, date-time, required
        - `id` string, required
      - `ownerUserId` string
      - `permissionScopes` string[], required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/rezible/apis/rezible-api.md) · [All operations](https://skmtc.net/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rezible/rezible-api/versions/d226beeef0bf/schema)