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

# Contribution

`GET /api/v1/index/contributions/{contribution_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}`
- Auth: none declared

## Path parameters

- `contribution_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

- ContributionView
  - `contribution_id` string, required
  - `title` string, nullable
  - `owner_id` string, required
  - `origin` 'user' | 'synth' | 'imported', required
  - `audience` 'private' | 'org' | 'public'
  - `status` 'draft' | 'published' | 'withdrawn', required
  - `generation` integer, required
  - `current_revision_id` string, nullable
  - `withdrawn` boolean
  - `withdrawal_reason` string, nullable
  - `contest_ids` string[]
  - `indexing_state` 'not_indexed' | 'pending' | 'indexed' | 'failed', nullable
  - `current` 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
  - `revisions` RevisionSummary[]
    - `revision_id` string, required
    - `reference` ContributionReference, required
      - `contribution_id` string, required
      - `revision_id` string, required
    - `parent_revision_id` string, nullable
    - `status` 'draft' | 'submitted' | 'changes_requested' | 'rejected' | 'qualified' | 'published' | 'withdrawn', required
    - `is_current` boolean
    - `title` string, nullable
    - `created_at` string, date-time, nullable
    - `submitted_at` string, date-time, nullable
    - `published_at` string, date-time, nullable

## 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)