---
title: "Get a private reference upload ticket; jobs:write"
method: POST
path: "/api/v1/uploads"
---

# Get a private reference upload ticket; jobs:write

`POST /api/v1/uploads`

## Request

- Base URL: `https://spritefuse.com`
- URL: `https://spritefuse.com/api/v1/uploads`
- Auth: HTTP bearer

## Request body

- object
  - `content_type` 'image/png' | 'image/jpeg' | 'image/webp', required
  - `size` integer, required

## Response `201`

reference_image_id, upload_url, method, content_type and expires_in

- object

## Other responses

- `400`: Invalid request
- `401`: Invalid, expired or revoked credential
- `403`: Scope or owner unavailable
- `404`: Owned resource not found
- `409`: Idempotency, timing or state conflict
- `422`: Invalid inputs or content safety rejection
- `429`: Rate limit; Retry-After is provided
- `503`: Temporary dependency failure

---

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