> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cekura.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agent Improvement Session

> Create + poll "Improve Agent" sessions launched from the Insights page.



## OpenAPI

````yaml get /observability/v1/agent-improvement-sessions/{id}/
openapi: 3.1.0
info:
  title: Cekura API
  version: v1
  description: >-
    Complete API documentation for the Cekura platform. This API provides
    endpoints for testing, observing, and evaluating AI voice agents — including
    managing agents, running evaluators, defining metrics, and analyzing call
    quality.
servers:
  - url: https://api.cekura.ai
security: []
paths:
  /observability/v1/agent-improvement-sessions/{id}/:
    get:
      tags:
        - observability
      description: >-
        Create + poll "Improve Agent" sessions launched from the Insights page.


        ``create`` resolves the target agent from the selected insights' example

        call logs, validates it is a VAPI / ElevenLabs agent with a configured

        provider key, then opens a Claude Agent SDK session (product-chat
        sandbox

        runtime) seeded to run generate-scenarios → self-improving-agent.
        Returns

        the new session row.


        ``retrieve`` / ``list`` are the poll surface: retrieve syncs the row's

        coarse status from the underlying sandbox run before returning, so the

        frontend just polls ``GET
        /agent-improvement-sessions/<id>/?project=<id>``.
      operationId: agent-improvement-sessions-retrieve
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this agent improvement session.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentImprovementSession'
          description: ''
      security:
        - api_key: []
components:
  schemas:
    AgentImprovementSession:
      type: object
      description: |-
        Read view of an Improve-Agent session — what the frontend polls to
        track progress. `provider_key` and other secrets are never serialized.
      properties:
        id:
          type: integer
          readOnly: true
        project:
          type: integer
          readOnly: true
        agent:
          type:
            - integer
            - 'null'
          readOnly: true
        provider:
          type: string
          readOnly: true
        insights:
          readOnly: true
        call_log_ids:
          readOnly: true
        status:
          enum:
            - pending
            - running
            - succeeded
            - failed
          type: string
          description: |-
            * `pending` - Pending
            * `running` - Running
            * `succeeded` - Succeeded
            * `failed` - Failed
          x-spec-enum-id: 7a7ee2ea425ee5c6
          readOnly: true
        conversation_id:
          type:
            - string
            - 'null'
          format: uuid
          readOnly: true
        message_id:
          type:
            - string
            - 'null'
          format: uuid
          readOnly: true
        error_message:
          type: string
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
  securitySchemes:
    api_key:
      type: apiKey
      name: X-CEKURA-API-KEY
      in: header
      description: >-
        API Key Authentication. It should be included in the header of each
        request.

````