---
title: "Reserve Artifact Publication"
method: POST
path: "/api/artifacts/reserve"
tags: ["artifacts"]
---

# Reserve Artifact Publication

`POST /api/artifacts/reserve`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/artifacts/reserve`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- ArtifactPublicationReservationRequest
  - `alt_text` string, nullable
  - `description` string, nullable
  - `filename` string, required
  - `kind` 'text' | 'markdown' | 'html' | 'csv' | 'json' | 'image' | 'audio' | 'video' | 'pdf' | 'archive' | 'file', required: Canonical presentation family for immutable artifact bytes.
  - `media_type` string, required
  - `ordinal` integer
  - `request_id` string, required
  - `sha256` string, required
  - `size_bytes` integer, required
  - `title` string, nullable

## Response `200`

Successful Response

- union
  - ArtifactPublicationAlreadyAvailable
    - `artifact_id` string, required
    - `expires_seconds` 0, required
    - `upload_headers` ArtifactEmptyUploadHeaders, required
    - `upload_required` false, required
    - `upload_url` unknown, required
  - ArtifactPublicationUploadRequired
    - `artifact_id` string, required
    - `expires_seconds` 1800, required
    - `upload_headers` ArtifactUploadHeaders, required
      - `Content-Type` 'application/octet-stream', required
      - `If-None-Match` '*', required
      - `x-amz-checksum-sha256` string, required
      - `x-amz-meta-artifact-organization` string, required
      - `x-amz-meta-artifact-sha256` string, required
    - `upload_required` true, required
    - `upload_url` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)