---
title: "Request Agent Turn"
method: POST
path: "/ai/agent_sessions/{id}/turns"
tags: ["AI"]
---

# Request Agent Turn

`POST /ai/agent_sessions/{id}/turns`

## Path parameters

- `id` string, required

## Request body

- RequestAgentTurnRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` RequestAgentTurnRequestAttributes, required
    - `message` string
    - `resume` AgentTurnResume
      - `respond` Part[]
        - `contentType` string
        - `custom` object
        - `kind` integer
        - `metadata` object
        - `resource` ResourcePart
          - `uri` string
        - `text` string
        - `toolRequest` ToolRequest
          - `input` unknown
          - `name` string
          - `partial` boolean
          - `ref` string
        - `toolResponse` ToolResponse
          - `content` Part[]
          - `name` string
          - `output` unknown
          - `ref` string
      - `restart` Part[]
        - `contentType` string
        - `custom` object
        - `kind` integer
        - `metadata` object
        - `resource` ResourcePart
          - `uri` string
        - `text` string
        - `toolRequest` ToolRequest
          - `input` unknown
          - `name` string
          - `partial` boolean
          - `ref` string
        - `toolResponse` ToolResponse
          - `content` Part[]
          - `name` string
          - `output` unknown
          - `ref` string

## Response `202`

Accepted

- RequestAgentTurnResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` AgentTurn, required
    - `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
          - `createdAt` string, date-time, required
          - `knowledgeEntityId` string
          - `knowledgeEvidenceId` string
          - `knowledgeRelationshipId` string
          - `summary` string, required
        - `id` string, required
      - `parentTurnId` string
      - `startedAt` string, date-time
      - `state` SessionStateRawMessage
        - `artifacts` Artifact[]
          - `metadata` object
          - `name` string
          - `parts` Part[], required
            - `contentType` string
            - `custom` object
            - `kind` integer
            - `metadata` object
            - `resource` ResourcePart
              - …
            - `text` string
            - `toolRequest` ToolRequest
              - …
            - `toolResponse` ToolResponse
              - …
        - `custom` unknown
        - `messages` Message[]
          - `content` Part[]
            - `contentType` string
            - `custom` object
            - `kind` integer
            - `metadata` object
            - `resource` ResourcePart
              - …
            - `text` string
            - `toolRequest` ToolRequest
              - …
            - `toolResponse` ToolResponse
              - …
          - `metadata` object
          - `role` string
        - `sessionId` string
      - `status` string, required
      - `updatedAt` string, date-time, 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/revisions/d226beeef0bf/schema)