---
title: "Revision"
method: GET
path: "/api/v1/index/contributions/{contribution_id}/revisions/{revision_id}"
tags: ["index-reads"]
---

# Revision

`GET /api/v1/index/contributions/{contribution_id}/revisions/{revision_id}`

## Request

- Base URL: `https://api.usesynth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usesynth.ai/api/v1/index/contributions/{contribution_id}/revisions/{revision_id}`
- Auth: none declared

## Path parameters

- `contribution_id` string, required
- `revision_id` string, required

## Query parameters

- `search_id` string, uuid, nullable

## Headers

- `Synth-Acceptance-Context` string, nullable
- `Synth-Acceptance-Signature` string, nullable

## Response `200`

Successful Response

- RevisionView: Withdrawn tombstones carry identity and status only, never content.
  - `reference` ContributionReference, required
    - `contribution_id` string, required
    - `revision_id` string, required
  - `status` 'draft' | 'submitted' | 'changes_requested' | 'rejected' | 'qualified' | 'published' | 'withdrawn', required
  - `is_current` boolean
  - `current_revision_id` string, nullable
  - `parent_revision_id` string, nullable
  - `manifest_digest` string, nullable
  - `publication_id` string, nullable
  - `created_at` string, date-time, nullable
  - `submitted_at` string, date-time, nullable
  - `published_at` string, date-time, nullable
  - `indexing_state` 'not_indexed' | 'pending' | 'indexed' | 'failed', nullable
  - `package` ContributionPackageOutput
    - `schema_version` 'synth.contribution.v1'
    - `contribution_id` string, required
    - `revision_id` string, required
    - `parent_revision_id` string, nullable
    - `kind` 'research_report' | 'dataset' | 'recipe' | 'implementation' | 'model' | 'replication' | 'engineering_note', required
    - `title` string, required
    - `abstract` string, required
    - `research_areas` ResearchArea[], required
    - `workflow_stages` WorkflowStage[], required
    - `tag_ids` string[]
    - `card` ResearchCard, required
      - `reusable` string, required
      - `how_to_use` string, required
      - `observed` string, required
      - `limitations` string, required
      - `resources` string, required
    - `assets` ContributionAsset[], required
      - `asset_id` string, required
      - `role` 'summary' | 'report' | 'code' | 'data' | 'model' | 'environment' | 'evidence' | 'reproduce', required
      - `object` ArtifactObjectDeclaration, required: One immutable manifest object addressed only by logical path and digest.
        - `logical_path` string, required
        - `digest_sha256` string, required
        - `size_bytes` integer, required
        - `media_type` string, required
      - `license` string, required
    - `claims` ContributionClaim[], required
      - `claim_id` string, required
      - `kind` 'empirical' | 'composition' | 'conformance' | 'diagnostic', required
      - `statement` string, required
      - `scope` string, required
      - `author_assessment` 'supported' | 'disproven' | 'inconclusive' | 'not_tested', required
      - `supporting_evidence_ids` string[]
      - `contradicting_evidence_ids` string[]
      - `missing_evidence_reason` string, nullable
    - `evidence` EvidenceReference[]
      - `evidence_id` string, required
      - `kind` 'comparison' | 'experiment' | 'evaluation' | 'trace' | 'manifest' | 'conformance', required
      - `asset_id` string, required
      - `locator` string, required
    - `provenance` ContributionProvenanceOutput, required
      - `origin` 'user' | 'synth' | 'imported', required
      - `contributors` CreditedContributor[], required
        - `principal_id` string, required
        - `roles` string[], required
      - `upstream` ContributionReference[]
        - `contribution_id` string, required
        - `revision_id` string, required
      - `tools` string[]
      - `relationships` ContributionRelationship[]
        - `kind` 'citation' | 'reuse' | 'derivation' | 'replication' | 'correction' | 'contradiction', required
        - `reference` ContributionReference, required
          - `contribution_id` string, required
          - `revision_id` string, required
        - `reason` string, nullable
    - `reproduction` Reproduction, required
      - `level` 'inspectable' | 'runnable' | 'reproduced' | 'not_applicable', required
      - `instructions` string, required
      - `expected_outputs` string, required
      - `restrictions` string, required
      - `entrypoint_asset_id` string, nullable
      - `environment_asset_ids` string[]
    - `publication_mode` 'private' | 'public_api' | 'public', nullable
    - `requested_audience` 'private' | 'org' | 'public'
    - `rights_attested` boolean, required
    - `sensitive_data` 'none_declared' | 'declared' | 'unknown', required
    - `revision_note` string, nullable
    - `author_annotations` PackagesContributionsAnnotationsAuthorAnnotations
      - `keywords` string[]
      - `metadata` AuthorMetadata
        - `research_areas` string[]
        - `workflow_stages` string[]
        - `topics` string[]
  - `assessments` AssessmentView[]
    - `assessment_id` string, required
    - `reference` ContributionReference, required
      - `contribution_id` string, required
      - `revision_id` string, required
    - `revision_id` string, required
    - `manifest_digest` string, required
    - `reviewer_id` string, required
    - `decision` 'approve' | 'request_changes' | 'reject', required
    - `comments` string, nullable
    - `claim_comments` ReviewClaimComment[]
      - `claim_id` string, required
      - `comment` string, required
    - `created_at` string, date-time, nullable
    - `status` 'draft' | 'submitted' | 'changes_requested' | 'rejected' | 'qualified' | 'published' | 'withdrawn'
  - `citation` Citation
    - `contribution_id` string, required
    - `revision_id` string, required
    - `manifest_digest` string, required
    - `url` string, uri, required
  - `annotations` ContributionAnnotations
    - `keywords` string[]
    - `metadata` ContributionMetadata
      - `research_areas` string[]
      - `workflow_stages` string[]
      - `topics` string[]
    - `contribution_id` string, required
    - `revision_id` string, required
    - `revision_digest_sha256` string, required
    - `annotation_version` string, required
    - `review` ContributionReview, required
      - `contribution_id` string, required
      - `revision_id` string, required
      - `revision_digest_sha256` string, required
      - `review_id` string, required
      - `rubric_version` string, required
      - `reviewed_at` string, date-time, required
      - `reviewer_id` string, required
      - `authority` 'synth', required
      - `quality` 'low' | 'med' | 'high', required
      - `confidence` 'low' | 'med' | 'high', required
      - `correctness` 'low' | 'med' | 'high', required
      - `evidence_references` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usesynth/apis/synth-api.md) - [All operations](https://skmtc.dev/usesynth/apis/synth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usesynth/apis/synth-api/revisions/4d199548e98a?raw)