Skip to main content
POST
/
v1
/
assets
Error
A valid request URL is required to generate request examples
{
  "asset_id": "asset_d8aad64dib2c7m3ae7j1",
  "upload_url": "https://storage.googleapis.com/storytell-assets/asset_d8aad64dib2c7m3ae7j1?X-Goog-Signature=...",
  "upload_method": "PUT",
  "upload_headers": {
    "Content-Type": "application/pdf"
  },
  "expires_at": "2026-05-23T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://dev.chief.bot/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Personal Access Token, sent verbatim as pat_<32 chars>. PATs are minted from the Chief settings UI.

Headers

​
X-Project-Id
string
required

Project identifier scoping the request. Required on every project-scoped public endpoint. Missing or malformed values respond with HTTP 400 and code publicapi.tenancy.project.missing.

Pattern: ^project_[a-z0-9]{20}$

Body

application/json
​
filename
string
required

Original filename. Used for display and ingest hints.

​
mime_type
string
required

RFC 6838 media type of the upload.

Response

Upload URL minted.

​
asset_id
string
required
Pattern: ^asset_[a-z0-9]{20}$
​
upload_url
string<uri>
required
​
upload_method
string
required

HTTP method to use for the upload. PUT today; resumable multi-part uploads may add new values without breaking the existing PUT flow.

Example:

"PUT"

​
upload_headers
object
required

Headers the client MUST apply verbatim to the upload request. Includes Content-Type.

​
expires_at
string<date-time>
required