> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # Retry the capture of a pull request head's snapshot that gave up > The reader's retry of a capture getPRReviewHeadSnapshot answered kind failed: the capture starts again and the answer is kind capturing. A capture in any other state is answered as getPRReviewHeadSnapshot answers it (capturing, or the snapshot itself), so the answer is always the current state. ref and base_sha are the head and base tip the detail read currently names, with the same 409 otherwise. Authorized like getPRReview, with the same indistinguishable 404. ## OpenAPI ````yaml api-reference/openapi.json POST /pr-reviews/{pullRequestID}/head-snapshot/capture openapi: 3.1.0 info: title: Aether API version: 0.1.0 servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /pr-reviews/{pullRequestID}/head-snapshot/capture: post: tags: - pr-reviews summary: Retry the capture of a pull request head's snapshot that gave up description: >- The reader's retry of a capture getPRReviewHeadSnapshot answered kind failed: the capture starts again and the answer is kind capturing. A capture in any other state is answered as getPRReviewHeadSnapshot answers it (capturing, or the snapshot itself), so the answer is always the current state. ref and base_sha are the head and base tip the detail read currently names, with the same 409 otherwise. Authorized like getPRReview, with the same indistinguishable 404. operationId: retryPRReviewHeadSnapshotCapture parameters: - in: path name: pullRequestID required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/RetryPRReviewHeadSnapshotCaptureRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/PRReviewHeadSnapshot' description: >- The capture's state after the retry: under way, or the snapshot itself '401': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Unauthorized '403': content: application/json: schema: anyOf: - $ref: '#/components/schemas/PrReviewsErrorResponse' - $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Not Found '409': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Conflict '422': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Internal Server Error '503': content: application/json: schema: $ref: '#/components/schemas/PrReviewsErrorResponse' description: Service Unavailable components: schemas: RetryPRReviewHeadSnapshotCaptureRequest: additionalProperties: false properties: base_sha: description: >- The base branch's tip the listing is taken against, a full lowercase commit SHA. pattern: ^[0-9a-f]{40}$ type: string ref: description: The head the snapshot describes, a full lowercase commit SHA. pattern: ^[0-9a-f]{40}$ type: string required: - ref - base_sha type: object PRReviewHeadSnapshot: discriminator: mapping: capturing: '#/components/schemas/PRReviewHeadSnapshotCapturing' failed: '#/components/schemas/PRReviewHeadSnapshotFailed' ready: '#/components/schemas/PRReviewHeadSnapshotReady' propertyName: kind oneOf: - $ref: '#/components/schemas/PRReviewHeadSnapshotReady' - $ref: '#/components/schemas/PRReviewHeadSnapshotCapturing' - $ref: '#/components/schemas/PRReviewHeadSnapshotFailed' PrReviewsErrorResponse: additionalProperties: false properties: code: enum: - account_deleting - aether_inference_unserved - agent_pr_blocked - agent_pr_pending - agent_profile_changed - app_identity_missing - attribution_unavailable - bad_gateway - bad_request - caller_inactive - conflict - connection_harness_mismatch - connection_not_held - contents_write_required - continuation_failed - continuation_unavailable - control_forbidden - embeddings_unavailable - fix_not_requested - fix_requests_unrecorded - forbidden - fork_branch_delete_unsupported - fork_forbidden - gateway_timeout - github_claim_unverified - github_failed - github_identity_mismatch - github_identity_required - github_push_access_required - github_reconnect_required - github_ref_not_found - gone - idempotency_key_reused - inference_proxy_unavailable - insufficient_credits - insufficient_inference_balance - internal_error - invalid_request - mcp_server_not_connected - message_not_queued - method_not_allowed - mode_forbidden - no_dispatch_target - not_acceptable - not_found - not_implemented - onboarding_already_completed - onboarding_requirements_missing - org_role_insufficient - org_suspended - payment_required - pr_review_actor_required - pr_review_publish_forbidden - precondition_failed - pull_request_closed - pull_request_mirror_failed - pull_request_not_mirrored - queued_stop_requires_discard - rate_limited - request_canceled - request_timeout - request_too_large - service_unavailable - stack_cycle - stack_too_large - stack_two_parents - stale_execution - stale_or_indeterminate - stale_pending_input - stream_delivery_gap - stream_event_conflict - task_awaiting_message - task_awaiting_tool_response - task_connection_disconnected - task_creator_deleted - task_ineligible - task_not_accepting_messages - task_not_pinnable - task_settings_changed - teleport_unavailable - unauthenticated - unsigned_aether_head - unsigned_commit - unsupported_changes - unsupported_media_type - untyped_error - validation_failed - workspace_git_unavailable - workspace_rejected minLength: 1 type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error - code type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting - agent_host_route_not_allowed - credential_kind_not_admitted type: string error: minLength: 1 type: string required: - error - code type: object PRReviewHeadSnapshotCapturing: additionalProperties: false properties: kind: enum: - capturing type: string required: - kind type: object PRReviewHeadSnapshotFailed: additionalProperties: false properties: error: minLength: 1 type: string kind: enum: - failed type: string required: - kind - error type: object PRReviewHeadSnapshotReady: additionalProperties: false properties: base_sha: maxLength: 40 minLength: 40 pattern: ^[0-9a-f]{40}$ type: string files: items: $ref: '#/components/schemas/PRReviewHeadSnapshotFile' type: array head_sha: maxLength: 40 minLength: 40 pattern: ^[0-9a-f]{40}$ type: string kind: enum: - ready type: string truncated: type: boolean required: - kind - head_sha - base_sha - truncated - files type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object PRReviewHeadSnapshotFile: additionalProperties: false properties: additions: format: int64 minimum: 0 type: integer category: $ref: '#/components/schemas/PRReviewFileCategory' deletions: format: int64 minimum: 0 type: integer head: $ref: '#/components/schemas/PRReviewHeadSnapshotContent' patch: type: string path: type: string previous_path: type: string status: $ref: '#/components/schemas/PRReviewDiffFileStatus' required: - path - status - category - additions - deletions type: object PRReviewFileCategory: enum: - implementation - tests - documentation - generated type: string PRReviewHeadSnapshotContent: discriminator: mapping: binary: '#/components/schemas/PRReviewHeadSnapshotContentBinary' omitted: '#/components/schemas/PRReviewHeadSnapshotContentOmitted' text: '#/components/schemas/PRReviewHeadSnapshotContentText' too_large: '#/components/schemas/PRReviewHeadSnapshotContentTooLarge' propertyName: kind oneOf: - $ref: '#/components/schemas/PRReviewHeadSnapshotContentText' - $ref: '#/components/schemas/PRReviewHeadSnapshotContentBinary' - $ref: '#/components/schemas/PRReviewHeadSnapshotContentTooLarge' - $ref: '#/components/schemas/PRReviewHeadSnapshotContentOmitted' PRReviewDiffFileStatus: enum: - added - removed - modified - renamed - copied - changed - unchanged type: string PRReviewHeadSnapshotContentBinary: additionalProperties: false properties: kind: enum: - binary type: string required: - kind type: object PRReviewHeadSnapshotContentOmitted: additionalProperties: false properties: kind: enum: - omitted type: string reason: minLength: 1 type: string required: - kind - reason type: object PRReviewHeadSnapshotContentText: additionalProperties: false properties: content: type: string kind: enum: - text type: string required: - kind - content type: object PRReviewHeadSnapshotContentTooLarge: additionalProperties: false properties: kind: enum: - too_large type: string required: - kind type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.