---
title: "Upload object"
method: POST
path: "/api/v1/objects/{objectPath}"
tags: ["objects"]
---

# Upload object

`POST /api/v1/objects/{objectPath}`

Uploads an object. The object must be 1 GiB or smaller.

## Path parameters

- `objectPath` string, required

## Headers

- `Authorization` string, required
- `Time-To-Live` integer
- `Distribution-Mode` 'force'

## Response `200`

Successful upload

- PathMetadata
  - `content_identifier` ContentIdentifier, required
    - `path` string, required — A valid path must not contain the following: - Spaces or Tabs - Special characters other than underscore (_), dash (-), period (.) and slash (/) - Non-ASCII characters such as accents or symbols Paths must not start with a leading space.
    - `checksum` string, required — The SHA-256 checksum of this object.
  - `size_bytes` integer, required
  - `last_updated_at` string, date-time, required
  - `expiry_time` string, date-time

## Other responses

- `400` — Bad request
- `413` — Content too large
- `500` — Internal server error
- `507` — Insuccifient Storage

---

[API](https://skmtc.net/anduril/apis/rest.md) · [All operations](https://skmtc.net/anduril/apis/rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anduril/rest/revisions/c2a841b48ac6/schema)