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

# Assistant get turn

> Use the connected instance's access context. Read identifiers and current state before submitting a mutation.

ReferenceApplies to: Unified engine deployments

## Related guidance

[Addresses and access](https://docs.e6data.com/transformation/http/access.md) · [Request identity](https://docs.e6data.com/transformation/http/request-identity.md) · [Errors and recovery](https://docs.e6data.com/transformation/http/errors.md) · [Pagination and results](https://docs.e6data.com/transformation/http/results.md)


## OpenAPI

````yaml openapi/transformation.json GET /api/v1/assistant/conversations/{conversation_id}/turns/{turn_id}
openapi: 3.1.0
info:
  description: >-
    HTTP contracts for the Unified engine. Requests use the connected
    deployment's access model and configured owner. Response examples are
    illustrative; inspect your engine response in your client. SQL-managed
    secrets, credentials, streaming pipelines and maintenance run through
    session operations.
  title: Laminar Unified HTTP API
  version: v1
servers:
  - url: https://engine.example.com
    description: >-
      Example engine origin. Replace it with your deployment URL and any API
      mount prefix.
security: []
paths:
  /api/v1/assistant/conversations/{conversation_id}/turns/{turn_id}:
    get:
      tags:
        - Assistant
      summary: assistant get turn
      description: >-
        Use the connected instance's access context. Read identifiers and
        current state before submitting a mutation.
      operationId: assistant_get_turn
      parameters:
        - in: path
          name: conversation_id
          required: true
          schema:
            format: uuid
            type: string
        - in: path
          name: turn_id
          required: true
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/app_agent_src_models_rs_TurnRecord'
          description: Successful response.
        default:
          content:
            application/json:
              example:
                error:
                  code: invalid_request
                  message: Check the request fields
              schema:
                $ref: '#/components/schemas/ApiError'
          description: A rejected or failed request. Inspect error.code before retrying.
components:
  schemas:
    app_agent_src_models_rs_TurnRecord:
      properties:
        actions:
          items:
            $ref: '#/components/schemas/app_agent_src_models_rs_ActionRecord'
          type: array
        active_millis:
          minimum: 0
          type: integer
        artifacts:
          items:
            $ref: '#/components/schemas/app_agent_src_models_rs_Artifact'
          type: array
        assistant_text:
          type: string
        cancel_requested:
          type: boolean
        context:
          anyOf:
            - $ref: '#/components/schemas/app_agent_src_models_rs_PageContext'
            - type: 'null'
        conversation_id:
          format: uuid
          type: string
        created_at:
          $ref: '#/components/schemas/shared_common_src_time_rs_WallClockTimestamp'
        error:
          anyOf:
            - type: string
            - type: 'null'
        message:
          type: string
        next_sequence:
          minimum: 0
          type: integer
        revision:
          minimum: 0
          type: integer
        scope:
          $ref: '#/components/schemas/app_agent_src_models_rs_TurnScope'
        status:
          $ref: '#/components/schemas/app_agent_src_models_rs_TurnStatus'
        steps:
          minimum: 0
          type: integer
        submission_id:
          format: uuid
          type: string
        turn_id:
          format: uuid
          type: string
        updated_at:
          $ref: '#/components/schemas/shared_common_src_time_rs_WallClockTimestamp'
        views:
          items:
            $ref: '#/components/schemas/app_agent_src_models_rs_UiView'
          type: array
      required:
        - turn_id
        - conversation_id
        - submission_id
        - message
        - scope
        - context
        - status
        - assistant_text
        - actions
        - artifacts
        - views
        - error
        - created_at
        - updated_at
        - revision
        - next_sequence
        - steps
        - cancel_requested
        - active_millis
      type: object
    ApiError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    app_agent_src_models_rs_ActionRecord:
      properties:
        action_id:
          format: uuid
          type: string
        arguments:
          description: JSON value; fields depend on the enclosing document or provider.
        effect:
          $ref: '#/components/schemas/app_agent_src_models_rs_ToolEffect'
        result:
          anyOf:
            - $ref: '#/components/schemas/app_agent_src_models_rs_ToolResult'
            - type: 'null'
        status:
          $ref: '#/components/schemas/app_agent_src_models_rs_ActionStatus'
        tool_call_id:
          type: string
        tool_name:
          type: string
      required:
        - action_id
        - tool_call_id
        - tool_name
        - arguments
        - effect
        - status
        - result
      type: object
    app_agent_src_models_rs_Artifact:
      oneOf:
        - allOf:
            - properties:
                kind:
                  const: sql
              required:
                - kind
              type: object
            - properties:
                content:
                  type: string
                draft_token:
                  anyOf:
                    - type: string
                    - type: 'null'
                title:
                  type: string
              required:
                - title
                - content
                - draft_token
              type: object
        - allOf:
            - properties:
                kind:
                  const: workload
              required:
                - kind
              type: object
            - properties:
                content:
                  description: >-
                    JSON value; fields depend on the enclosing document or
                    provider.
                draft_token:
                  anyOf:
                    - type: string
                    - type: 'null'
                title:
                  type: string
              required:
                - title
                - content
                - draft_token
              type: object
        - allOf:
            - properties:
                kind:
                  const: notebook
              required:
                - kind
              type: object
            - properties:
                content:
                  description: >-
                    JSON value; fields depend on the enclosing document or
                    provider.
                draft_token:
                  anyOf:
                    - type: string
                    - type: 'null'
                title:
                  type: string
              required:
                - title
                - content
                - draft_token
              type: object
        - allOf:
            - properties:
                kind:
                  const: dashboard
              required:
                - kind
              type: object
            - properties:
                content:
                  description: >-
                    JSON value; fields depend on the enclosing document or
                    provider.
                draft_token:
                  anyOf:
                    - type: string
                    - type: 'null'
                title:
                  type: string
              required:
                - title
                - content
                - draft_token
              type: object
    app_agent_src_models_rs_PageContext:
      properties:
        content:
          anyOf:
            - type: string
            - type: 'null'
        draft_token:
          anyOf:
            - type: string
            - type: 'null'
        page:
          type: string
        resource_id:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - page
        - resource_id
        - draft_token
        - content
      type: object
    shared_common_src_time_rs_WallClockTimestamp:
      properties:
        unix_millis:
          type: integer
      required:
        - unix_millis
      type: object
    app_agent_src_models_rs_TurnScope:
      oneOf:
        - const: read
          type: string
        - const: draft
          type: string
        - const: execute
          type: string
    app_agent_src_models_rs_TurnStatus:
      oneOf:
        - const: queued
          type: string
        - const: running
          type: string
        - const: waiting_approval
          type: string
        - const: completed
          type: string
        - const: failed
          type: string
        - const: cancelled
          type: string
        - const: interrupted
          type: string
    app_agent_src_models_rs_UiView:
      properties:
        data_refs:
          items:
            $ref: '#/components/schemas/app_agent_src_models_rs_UiDataRef'
          type: array
        library_version:
          minimum: 0
          type: integer
        source:
          type: string
        title:
          type: string
        view_id:
          format: uuid
          type: string
      required:
        - view_id
        - title
        - library_version
        - source
        - data_refs
      type: object
    app_agent_src_models_rs_ToolEffect:
      oneOf:
        - const: read
          type: string
        - const: execute
          type: string
        - const: admin
          type: string
    app_agent_src_models_rs_ToolResult:
      properties:
        data:
          description: JSON value; fields depend on the enclosing document or provider.
        is_error:
          type: boolean
      required:
        - is_error
        - data
      type: object
    app_agent_src_models_rs_ActionStatus:
      oneOf:
        - const: pending_approval
          type: string
        - const: approved
          type: string
        - const: dispatching
          type: string
        - const: succeeded
          type: string
        - const: failed
          type: string
        - const: outcome_unknown
          type: string
        - const: rejected
          type: string
    app_agent_src_models_rs_UiDataRef:
      properties:
        action_id:
          format: uuid
          type: string
        name:
          type: string
      required:
        - name
        - action_id
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.