---
title: "Contents"
method: POST
path: "/api/v1/index/contents"
tags: ["index"]
---

# Contents

`POST /api/v1/index/contents`

## 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/contents`
- Auth: none declared

## Request body

- ContentsSpec
  - `references` ContributionReference[], required
    - `contribution_id` string, required
    - `revision_id` string, required
  - `search_id` string, nullable
  - `max_bytes` integer

## Response `200`

Successful Response

- ContentsResult
  - `request_id` string, required
  - `items` ContentsItem[], required
    - `reference` ContributionReference, required
      - `contribution_id` string, required
      - `revision_id` string, required
    - `status` 'available' | 'unavailable', required
    - `asset_id` string, nullable
    - `text` string, nullable
    - `asset_digest_sha256` string, nullable
    - `logical_path` string, nullable
    - `start_byte` integer, nullable
    - `end_byte` integer, 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)