---
title: "Upload media to Encircle"
method: POST
path: "/v1/upload"
tags: ["Media Upload"]
---

# Upload media to Encircle

`POST /v1/upload`

Uploads media from the raw request body and returns a temporary `upload_id`
which expires after 24 hours from being issued.

The `upload_id` should be used within that time to attach the `Upload` to
another object, such as a `Property Claim`.

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Request body

- unknown

## Response `200`

The `Upload` was successfully created.

- object — A file `Upload` comprised of the raw request body.
  - `upload_id` string, uuid, required — Used for attaching media to an object. They are created via `POST` `/upload` and expire after 24 hours since being issued. A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.

## Other responses

- `400` — Error processing request.
- `401` — Authentication error.
- `404` — Requested resource does not exist.

---

[API](https://skmtc.net/encircleapp/apis/encircle-public-api.md) · [All operations](https://skmtc.net/encircleapp/apis/encircle-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/encircleapp/encircle-public-api/versions/0e70222a2c6d/schema)