> ## Documentation Index > Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt > Use this file to discover all available pages before exploring further. # Read one authoring turn and its durable result ## OpenAPI ````yaml /api-reference/openapi.json get /v1/projects/{projectId}/authoring-sessions/{authoringSessionId}/turns/{authoringTurnId} openapi: 3.1.0 info: title: Firedrill Control API version: 1.0.0 description: >- The control plane for drills, drill runs, and the worlds they run in. Errors always carry the canonical envelope; unsafe operations require an Idempotency-Key; long work returns an operation resource. servers: - url: https://api.firedrill.run security: - controlCredential: [] paths: /v1/projects/{projectId}/authoring-sessions/{authoringSessionId}/turns/{authoringTurnId}: get: summary: Read one authoring turn and its durable result operationId: authoring.getTurn parameters: - name: projectId in: path required: true schema: type: string pattern: ^prj_[0-9a-z]{12,32}$ - name: authoringSessionId in: path required: true schema: type: string pattern: ^authsess_[0-9a-z]{12,32}$ - name: authoringTurnId in: path required: true schema: type: string pattern: ^aturn_[0-9a-z]{12,32}$ responses: '200': description: Read one authoring turn and its durable result content: application/json: schema: $ref: '#/components/schemas/AuthoringTurn' default: description: Canonical error envelope content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: AuthoringTurn: type: object properties: schemaVersion: type: number enum: - 1 authoringTurnId: type: string pattern: ^aturn_[0-9a-z]{12,32}$ authoringSessionId: type: string pattern: ^authsess_[0-9a-z]{12,32}$ organizationId: type: string pattern: ^org_[0-9a-z]{12,32}$ projectId: type: string pattern: ^prj_[0-9a-z]{12,32}$ sequence: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 prompt: type: string minLength: 1 maxLength: 32768 model: type: string enum: - opus - sonnet - haiku effort: type: string enum: - low - medium - high - xhigh - max maxTurns: type: integer minimum: 0 exclusiveMinimum: true maximum: 200 maxBudgetUsd: type: number minimum: 0 exclusiveMinimum: true maximum: 1000 timeoutMs: type: integer minimum: 1000 maximum: 7200000 state: type: string enum: - queued - running - succeeded - unchanged - failed - cancelled operationId: type: string pattern: ^op_[0-9a-z]{12,32}$ proposalId: type: string pattern: ^aprop_[0-9a-z]{12,32}$ agentSessionId: type: string minLength: 1 maxLength: 255 actualModel: type: string minLength: 1 maxLength: 255 turnsUsed: type: integer minimum: 0 maximum: 200 durationMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 estimatedCostUsd: type: number minimum: 0 maximum: 999999.999999 resultText: type: string maxLength: 100000 error: type: object properties: schemaVersion: type: number enum: - 1 code: type: string pattern: ^[a-z][a-z0-9-]*\.[A-Z][A-Z0-9_]*$ source: type: string enum: - framework - world - tool - target - assertion - reporter - control message: type: string minLength: 1 maxLength: 4000 retryable: type: boolean correlationId: type: string pattern: ^corr_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ issues: default: [] type: array items: type: object properties: code: type: string minLength: 1 maxLength: 128 message: type: string minLength: 1 maxLength: 2000 path: type: array items: anyOf: - type: string - type: integer minimum: 0 maximum: 9007199254740991 suggestion: type: string minLength: 1 maxLength: 4000 required: - code - message additionalProperties: {} details: type: object additionalProperties: $ref: '#/components/schemas/AuthoringTurn___schema0' evidence: type: object properties: runId: type: string pattern: ^run_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ sequence: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 additionalProperties: {} required: - schemaVersion - code - source - message - retryable - issues additionalProperties: {} context: maxItems: 16 type: array items: type: object properties: reference: oneOf: - type: object properties: kind: type: string enum: - environment environmentId: type: string pattern: ^env_[0-9a-z]{12,32}$ required: - kind - environmentId additionalProperties: false - type: object properties: kind: type: string enum: - build buildHash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - kind - buildHash additionalProperties: false - type: object properties: kind: type: string enum: - libraryTool libraryEntryId: type: string pattern: ^[a-z0-9][a-z0-9-]{0,79}$ required: - kind - libraryEntryId additionalProperties: false - type: object properties: kind: type: string enum: - library required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - upload agentUploadId: type: string pattern: ^aupl_[0-9a-z]{12,32}$ required: - kind - agentUploadId additionalProperties: false - type: object properties: kind: type: string enum: - sourceDraft sourceDraftId: type: string pattern: ^draft_[0-9a-z]{12,32}$ required: - kind - sourceDraftId additionalProperties: false - type: object properties: kind: type: string enum: - run hostedRunId: type: string pattern: ^hrun_[0-9a-z]{12,32}$ required: - kind - hostedRunId additionalProperties: false - type: object properties: kind: type: string enum: - buildAttempt buildAttemptId: type: string pattern: ^attempt_[0-9a-z]{12,32}$ required: - kind - buildAttemptId additionalProperties: false - type: object properties: kind: type: string enum: - simulation batchId: type: string pattern: ^cisuite_[0-9a-z]{12,32}$ required: - kind - batchId additionalProperties: false availability: type: string enum: - attached - partial - retained_only - unavailable label: type: string minLength: 1 maxLength: 200 version: type: string minLength: 1 maxLength: 200 note: type: string minLength: 1 maxLength: 500 required: - reference - availability - label additionalProperties: false draft: oneOf: - type: object properties: mode: type: string enum: - edit sourceDraftId: type: string pattern: ^draft_[0-9a-z]{12,32}$ name: type: string minLength: 1 maxLength: 160 version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 revision: type: integer minimum: 1 maximum: 2147483647 sourceDigest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - mode - sourceDraftId - name - version - revision - sourceDigest additionalProperties: false - type: object properties: mode: type: string enum: - new name: type: string minLength: 1 maxLength: 160 required: - mode - name additionalProperties: false cancelRequestedAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 createdAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 startedAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 finishedAtMs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - schemaVersion - authoringTurnId - authoringSessionId - organizationId - projectId - sequence - prompt - model - effort - maxTurns - maxBudgetUsd - timeoutMs - state - operationId - createdAtMs additionalProperties: false ErrorEnvelope: type: object properties: code: type: string pattern: ^(control|world)\.[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ message: type: string minLength: 1 correlationId: type: string minLength: 1 retryable: type: boolean retryAfterMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 operationId: type: string source: type: string enum: - platform - simulated_provider issues: type: array items: type: object properties: path: type: string code: type: string message: type: string required: - path - code - message additionalProperties: false details: type: object propertyNames: type: string additionalProperties: {} evidence: type: object properties: sessionId: type: string runId: type: string journalSeq: type: integer minimum: 0 maximum: 9007199254740991 buildHash: type: string additionalProperties: false required: - code - message - correlationId - retryable - source additionalProperties: true AuthoringTurn___schema0: description: Any JSON-compatible value securitySchemes: controlCredential: type: http scheme: bearer description: Opaque control credential ````