---
title: "Prepare Artifact"
method: POST
path: "/v1/segmentations/{job_id}/artifacts/{kind}/prepare"
---

# Prepare Artifact

`POST /v1/segmentations/{job_id}/artifacts/{kind}/prepare`

## Request

- Base URL: `https://api.segly.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.segly.io/v1/segmentations/{job_id}/artifacts/{kind}/prepare`
- Auth: HTTP bearer

## Path parameters

- `job_id` string, required
- `kind` string, required

## Request body

- ArtifactPrepareRequest
  - `retry` boolean

## Response `202`

Successful Response

- ArtifactResource
  - `kind` string, required
  - `status` 'pending' | 'processing' | 'ready' | 'failed', required
  - `url` string, nullable
  - `content_type` string, nullable
  - `size_bytes` integer, nullable
  - `sha256` string, nullable
  - `expires_at` string, date-time, nullable
  - `retry_after_ms` integer, nullable
  - `message` string, nullable
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/segly/apis/segly-io-api.md) · [All operations](https://skmtc.dev/segly/apis/segly-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/segly/apis/segly-io-api/revisions/f831b05317d0?raw)