> ## Documentation Index > Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get Agent Run Checkpoint Snapshot > Return a derived run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run. ## OpenAPI ````yaml get /agents/{agent_id}/runs/{run_id}/checkpoints/{message_index} openapi: 3.1.0 info: title: Agno API Reference description: The all-in-one, private, secure agent platform that runs in your cloud. version: 2.7.4 servers: [] security: [] paths: /agents/{agent_id}/runs/{run_id}/checkpoints/{message_index}: get: tags: - Agents summary: Get Agent Run Checkpoint Snapshot description: >- Return a derived run snapshot truncated at a message boundary. Use the returned message_index as `continue_from` when continuing this run. operationId: get_agent_run_checkpoint_snapshot parameters: - name: agent_id in: path required: true schema: type: string title: Agent Id - name: run_id in: path required: true schema: type: string title: Run Id - name: message_index in: path required: true schema: type: integer title: Message Index - name: session_id in: query required: true schema: type: string description: Session ID for the run title: Session Id description: Session ID for the run responses: '200': description: Run checkpoint snapshot retrieved successfully content: application/json: schema: $ref: '#/components/schemas/RunCheckpointSnapshotResponse' '400': description: Invalid checkpoint message index content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' '404': description: Agent or run not found content: application/json: schema: $ref: '#/components/schemas/NotFoundResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' security: - {} - HTTPBearer: [] components: schemas: RunCheckpointSnapshotResponse: properties: checkpoint: $ref: '#/components/schemas/RunCheckpointEntry' snapshot: anyOf: - $ref: '#/components/schemas/RunSchema' - $ref: '#/components/schemas/TeamRunSchema' title: Snapshot description: Agent or team run serialized at the requested message boundary. type: object required: - checkpoint - snapshot title: RunCheckpointSnapshotResponse BadRequestResponse: properties: detail: type: string title: Detail description: Error detail message error_code: anyOf: - type: string - type: 'null' title: Error Code description: Error code for categorization type: object required: - detail title: BadRequestResponse example: detail: Bad request error_code: BAD_REQUEST UnauthenticatedResponse: properties: detail: type: string title: Detail description: Error detail message error_code: anyOf: - type: string - type: 'null' title: Error Code description: Error code for categorization type: object required: - detail title: UnauthenticatedResponse example: detail: Unauthenticated access error_code: UNAUTHENTICATED ForbiddenResponse: properties: detail: type: string title: Detail description: Error detail message type: object required: - detail title: ForbiddenResponse example: detail: Insufficient permissions NotFoundResponse: properties: detail: type: string title: Detail description: Error detail message error_code: anyOf: - type: string - type: 'null' title: Error Code description: Error code for categorization type: object required: - detail title: NotFoundResponse example: detail: Not found error_code: NOT_FOUND ValidationErrorResponse: properties: detail: type: string title: Detail description: Error detail message error_code: anyOf: - type: string - type: 'null' title: Error Code description: Error code for categorization type: object required: - detail title: ValidationErrorResponse example: detail: Validation error error_code: VALIDATION_ERROR InternalServerErrorResponse: properties: detail: type: string title: Detail description: Error detail message error_code: anyOf: - type: string - type: 'null' title: Error Code description: Error code for categorization type: object required: - detail title: InternalServerErrorResponse example: detail: Internal server error error_code: INTERNAL_SERVER_ERROR RunCheckpointEntry: properties: checkpoint_id: anyOf: - type: string - type: 'null' title: Checkpoint Id description: >- One-based display ID, or null when the requested boundary is not on the checkpoint timeline. run_id: anyOf: - type: string - type: 'null' title: Run Id description: Run that contains the checkpoint. session_id: anyOf: - type: string - type: 'null' title: Session Id description: Session that contains the run. message_index: type: integer minimum: 0 title: Message Index description: Message boundary represented by the checkpoint. continue_from: type: integer minimum: 0 title: Continue From description: Value to send as continue_from when continuing the run. status: anyOf: - type: string - type: 'null' title: Status description: Checkpoint status or current run status. reason: type: string title: Reason description: Why this boundary was returned. created_at: anyOf: - type: integer - type: 'null' title: Created At description: Unix timestamp for the checkpoint or run. message_id: anyOf: - type: string - type: 'null' title: Message Id description: Message ID at the checkpoint boundary. message_role: anyOf: - type: string - type: 'null' title: Message Role description: Role of the message at the checkpoint boundary. message_preview: anyOf: - type: string - type: 'null' title: Message Preview description: Truncated message content at the checkpoint boundary. is_latest: type: boolean title: Is Latest description: Whether this is the final message boundary in the stored run. type: object required: - checkpoint_id - run_id - session_id - message_index - continue_from - status - reason - created_at - message_id - message_role - message_preview - is_latest title: RunCheckpointEntry description: A continuation boundary derived from a stored run transcript. RunSchema: properties: run_id: type: string title: Run Id description: Unique identifier for the run parent_run_id: anyOf: - type: string - type: 'null' title: Parent Run Id description: Parent run ID if this is a nested run agent_id: anyOf: - type: string - type: 'null' title: Agent Id description: Agent ID that executed this run user_id: anyOf: - type: string - type: 'null' title: User Id description: User ID associated with the run status: anyOf: - type: string - type: 'null' title: Status description: Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.) run_input: anyOf: - type: string - type: 'null' title: Run Input description: Input provided to the run content: anyOf: - type: string - additionalProperties: true type: object - type: 'null' title: Content description: Output content from the run run_response_format: anyOf: - type: string - type: 'null' title: Run Response Format description: Format of the response (text/json) reasoning_content: anyOf: - type: string - type: 'null' title: Reasoning Content description: Reasoning content if reasoning was enabled reasoning_steps: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Steps description: List of reasoning steps metrics: anyOf: - additionalProperties: true type: object - type: 'null' title: Metrics description: Performance and usage metrics messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Messages description: Message history for the run tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: Tools used in the run events: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Events description: Events generated during the run created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Run creation timestamp references: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: References description: References cited in the run citations: anyOf: - additionalProperties: true type: object - type: 'null' title: Citations description: Citations from the model (e.g., from Gemini grounding/search) reasoning_messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Messages description: Reasoning process messages session_state: anyOf: - additionalProperties: true type: object - type: 'null' title: Session State description: Session state at the end of the run images: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Images description: Images included in the run videos: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Videos description: Videos included in the run audio: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Audio description: Audio files included in the run files: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Files description: Files included in the run response_audio: anyOf: - additionalProperties: true type: object - type: 'null' title: Response Audio description: Audio response if generated input_media: anyOf: - additionalProperties: true type: object - type: 'null' title: Input Media description: Input media attachments followups: anyOf: - items: type: string type: array - type: 'null' title: Followups description: Followup suggestions generated after the run forked_from_run_id: anyOf: - type: string - type: 'null' title: Forked From Run Id description: If this run was forked from another run, the source run's ID forked_from_message_index: anyOf: - type: integer - type: 'null' title: Forked From Message Index description: >- If this run was forked, the message index at which the source was truncated forked_from_session_id: anyOf: - type: string - type: 'null' title: Forked From Session Id description: If this run was created via session branch, the source session's ID regenerated_from: anyOf: - type: string - type: 'null' title: Regenerated From description: If this run was produced via regenerate=true, the source run's ID last_checkpoint_at_message_index: anyOf: - type: integer - type: 'null' title: Last Checkpoint At Message Index description: >- Message index of the most recent mid-run checkpoint (checkpoint='tool-batch' runs) type: object required: - run_id title: RunSchema TeamRunSchema: properties: run_id: type: string title: Run Id description: Unique identifier for the team run parent_run_id: anyOf: - type: string - type: 'null' title: Parent Run Id description: Parent run ID if this is a nested run team_id: anyOf: - type: string - type: 'null' title: Team Id description: Team ID that executed this run status: anyOf: - type: string - type: 'null' title: Status description: Run status (PENDING, RUNNING, COMPLETED, ERROR, etc.) content: anyOf: - type: string - additionalProperties: true type: object - type: 'null' title: Content description: Output content from the team run reasoning_content: anyOf: - type: string - type: 'null' title: Reasoning Content description: Reasoning content if reasoning was enabled reasoning_steps: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Steps description: List of reasoning steps run_input: anyOf: - type: string - type: 'null' title: Run Input description: Input provided to the run run_response_format: anyOf: - type: string - type: 'null' title: Run Response Format description: Format of the response (text/json) metrics: anyOf: - additionalProperties: true type: object - type: 'null' title: Metrics description: Performance and usage metrics tools: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Tools description: Tools used in the run messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Messages description: Message history for the run events: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Events description: Events generated during the run created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Run creation timestamp references: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: References description: References cited in the run citations: anyOf: - additionalProperties: true type: object - type: 'null' title: Citations description: Citations from the model (e.g., from Gemini grounding/search) reasoning_messages: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Reasoning Messages description: Reasoning process messages session_state: anyOf: - additionalProperties: true type: object - type: 'null' title: Session State description: Session state at the end of the run input_media: anyOf: - additionalProperties: true type: object - type: 'null' title: Input Media description: Input media attachments images: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Images description: Images included in the run videos: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Videos description: Videos included in the run audio: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Audio description: Audio files included in the run files: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Files description: Files included in the run response_audio: anyOf: - additionalProperties: true type: object - type: 'null' title: Response Audio description: Audio response if generated followups: anyOf: - items: type: string type: array - type: 'null' title: Followups description: Followup suggestions generated after the run forked_from_run_id: anyOf: - type: string - type: 'null' title: Forked From Run Id description: If this team run was forked from another run, the source run's ID forked_from_message_index: anyOf: - type: integer - type: 'null' title: Forked From Message Index description: >- If this team run was forked, the message index at which the source was truncated forked_from_session_id: anyOf: - type: string - type: 'null' title: Forked From Session Id description: >- If this team run was created via session branch, the source session's ID regenerated_from: anyOf: - type: string - type: 'null' title: Regenerated From description: >- If this team run was produced via regenerate=true, the source run's ID last_checkpoint_at_message_index: anyOf: - type: integer - type: 'null' title: Last Checkpoint At Message Index description: >- Message index of the most recent mid-run checkpoint (checkpoint='tool-batch' runs) type: object required: - run_id title: TeamRunSchema securitySchemes: HTTPBearer: type: http scheme: bearer ````