> ## Documentation Index > Fetch the complete documentation index at: https://docs.akua.dev/llms.txt > Use this file to discover all available pages before exploring further. # Recover committed agent response parts > Reads only persisted response chunks after a session cursor. This bounded recovery read is separate from the live Temporal Workflow Stream. ## OpenAPI ````yaml /openapi-public.json get /agent_response_parts openapi: 3.1.0 info: title: Akua API version: 1.0.0 description: >- Public API for managing Akua workspaces, clusters, products, and installs. Authenticate with a workspace API token via the `Authorization: Bearer sk_akua_...` header. A workspace-owned token implies its workspace. Broad tokens select the active workspace via the optional `Akua-Context` header. contact: name: Akua API support email: support@akua.dev url: https://akua.dev/docs servers: - url: https://api.akua.dev/v1 description: Production security: [] tags: - name: Auth description: Authentication and token management. - name: Agents description: Agent identities and configuration. - name: Agent sessions description: Durable agent conversations and tasks. - name: Agent turns description: Submitted agent work and event emission. - name: Agent events description: Normalized agent event history and streams. - name: Custom domains description: Workspace custom domains and routing targets. - name: Cloudflare description: Cloudflare account credentials and gateway control. - name: Clusters description: Kubernetes clusters and cluster access operations. - name: ComputeConfigs description: Workspace compute provider configurations. - name: Entitlements description: Effective workspace capabilities and limits. - name: Dashboards description: Dashboard and widget resources. - name: Installs description: Installation and render operations. - name: Machines description: Compute machines and lifecycle events. - name: Notifications description: User notification state. - name: Offer Channels description: Private offer channels and policy versions. - name: Offers description: Marketplace offers and redemption tracking. - name: Operations description: Long-running operation status and controls. - name: Order Drafts description: Draft checkout orders and checkout sessions. - name: Organizations description: Organizations, memberships, and managed workspaces. - name: Packages description: Software packages, versions, and input schemas. - name: Products description: Marketplace product catalog resources. - name: Preview hostnames description: Install preview hostnames and routing state. - name: Quotas description: Workspace quota limits and usage. - name: Regions description: Available deployment regions. - name: Registry description: Container registry credentials and repositories. - name: Repository change requests description: Fork-backed repository change reviews and lifecycle actions. - name: Repositories description: Source repositories available to the workspace. - name: Secrets description: Workspace secrets and secret versions. - name: Snippets description: Reusable snippets and snippet runs. - name: Workspace subdomains description: Workspace subdomain identity. - name: Workspaces description: Workspace resources, members, and billing state. paths: /agent_response_parts: get: tags: - Agent events summary: Recover committed agent response parts description: >- Reads only persisted response chunks after a session cursor. This bounded recovery read is separate from the live Temporal Workflow Stream. operationId: agentEvents.listResponseParts parameters: - name: akua-context in: header schema: type: string minLength: 1 maxLength: 54 required: false - name: session in: query schema: type: string pattern: ^(?:ags_)?[a-zA-Z0-9]{1,50}$ required: true - name: after in: query schema: type: integer minimum: 0 maximum: 9007199254740991 required: false - name: limit in: query schema: type: integer minimum: 1 maximum: 100 required: false responses: '200': description: AgentResponsePartList content: application/json: schema: $ref: '#/components/schemas/EffectAgentResponsePartList' '400': description: The request is malformed. content: application/json: schema: $ref: '#/components/schemas/EffectApiBadRequestEncoded' '401': description: Missing, invalid or expired credential. content: application/json: schema: $ref: '#/components/schemas/EffectApiUnauthorizedEncoded' '403': description: The credential may not act in this workspace. content: application/json: schema: $ref: '#/components/schemas/EffectApiForbiddenEncoded' '404': description: The resource was not found in this workspace. content: application/json: schema: $ref: '#/components/schemas/EffectApiNotFoundEncoded' '503': description: The service is temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/EffectApiServiceUnavailableEncoded' security: - BearerAuth: [] components: schemas: EffectAgentResponsePartList: type: object properties: data: type: array items: type: object properties: cursor: type: integer minimum: 1 maximum: 9007199254740991 stream_id: type: string minLength: 1 maxLength: 200 generation: type: integer minimum: 1 maximum: 9007199254740991 chunk: anyOf: - type: object properties: type: type: string enum: - start messageId: type: string minLength: 1 maxLength: 200 required: - type - messageId additionalProperties: false - type: object properties: type: type: string enum: - text-start - text-end - reasoning-start - reasoning-end id: type: string minLength: 1 maxLength: 200 required: - type - id additionalProperties: false - type: object properties: type: type: string enum: - text-delta - reasoning-delta id: type: string minLength: 1 maxLength: 200 delta: type: string maxLength: 32768 required: - type - id - delta additionalProperties: false - type: object properties: type: type: string enum: - tool-input-start toolCallId: type: string minLength: 1 maxLength: 200 toolName: type: string minLength: 1 maxLength: 200 required: - type - toolCallId - toolName additionalProperties: false - type: object properties: type: type: string enum: - tool-input-delta toolCallId: type: string minLength: 1 maxLength: 200 inputTextDelta: type: string maxLength: 32768 required: - type - toolCallId - inputTextDelta additionalProperties: false - type: object properties: type: type: string enum: - tool-input-available toolCallId: type: string minLength: 1 maxLength: 200 toolName: type: string minLength: 1 maxLength: 200 input: {} required: - type - toolCallId - toolName - input additionalProperties: false - type: object properties: type: type: string enum: - tool-output-available toolCallId: type: string minLength: 1 maxLength: 200 output: {} required: - type - toolCallId - output additionalProperties: false - type: object properties: type: type: string enum: - tool-output-error toolCallId: type: string minLength: 1 maxLength: 200 errorText: type: string maxLength: 4096 required: - type - toolCallId - errorText additionalProperties: false - type: object properties: type: type: string enum: - tool-output-denied toolCallId: type: string minLength: 1 maxLength: 200 required: - type - toolCallId additionalProperties: false - type: object properties: type: type: string enum: - start-step - finish-step required: - type additionalProperties: false - type: object properties: type: type: string enum: - finish finishReason: type: string enum: - stop - length - content-filter - tool-calls - error - other required: - type additionalProperties: false - type: object properties: type: type: string enum: - abort reason: type: string maxLength: 4096 required: - type additionalProperties: false - type: object properties: type: type: string enum: - error errorText: type: string maxLength: 4096 required: - type - errorText additionalProperties: false required: - cursor - stream_id - generation - chunk additionalProperties: false high_watermark: type: integer minimum: 0 maximum: 9007199254740991 has_more: type: boolean next_cursor: anyOf: - type: string minLength: 1 - type: 'null' required: - data - high_watermark - has_more - next_cursor additionalProperties: false EffectApiBadRequestEncoded: type: object properties: success: type: boolean enum: - false errors: type: array prefixItems: - $ref: '#/components/schemas/EffectApiErrorEntry' minItems: 1 items: $ref: '#/components/schemas/EffectApiErrorEntry' result: type: object additionalProperties: false required: - success - errors - result additionalProperties: false EffectApiUnauthorizedEncoded: type: object properties: success: type: boolean enum: - false errors: type: array prefixItems: - $ref: '#/components/schemas/EffectApiErrorEntry' minItems: 1 items: $ref: '#/components/schemas/EffectApiErrorEntry' result: type: object additionalProperties: false required: - success - errors - result additionalProperties: false EffectApiForbiddenEncoded: type: object properties: success: type: boolean enum: - false errors: type: array prefixItems: - $ref: '#/components/schemas/EffectApiErrorEntry' minItems: 1 items: $ref: '#/components/schemas/EffectApiErrorEntry' result: type: object additionalProperties: false required: - success - errors - result additionalProperties: false EffectApiNotFoundEncoded: type: object properties: success: type: boolean enum: - false errors: type: array prefixItems: - $ref: '#/components/schemas/EffectApiErrorEntry' minItems: 1 items: $ref: '#/components/schemas/EffectApiErrorEntry' result: type: object additionalProperties: false required: - success - errors - result additionalProperties: false EffectApiServiceUnavailableEncoded: type: object properties: success: type: boolean enum: - false errors: type: array prefixItems: - $ref: '#/components/schemas/EffectApiErrorEntry' minItems: 1 items: $ref: '#/components/schemas/EffectApiErrorEntry' result: type: object additionalProperties: false required: - success - errors - result additionalProperties: false EffectApiErrorEntry: type: object properties: code: type: integer message: type: string path: type: array items: type: string required: - code - message additionalProperties: false securitySchemes: BearerAuth: type: http scheme: bearer description: >- workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.