v1alpha1

Start a file upload

Changed on Oct 26, 2026

Creates a pending file and returns a signed putUrl with the putHeaders to send with it, plus the file's fileId and ref. Upload the bytes to putUrl, then call POST /files/{file_id}/complete.

Answers 400 for a content type that is not allowed, 404 when uploads are off for this assistant, 429 when the member has too many pending uploads and 503 when uploads are unavailable.

Error bodies are described in the error contract.

post/api/v1alpha1/assistant/trademe/files

Request

Base URL
https://api.trademeai.co.nz (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/trademeai/apis/trade-me-ai-platform/docs/api/v1alpha1/assistant/trademe/files/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

authorizationstring nullable

Request body

contentTypestring required

Response

Successful Response

fileIdstring required

refstring required

putUrlstring required

expiresAtstring date-time required

Changes

Oct 26, 2026000c37922939 Revision changes
- info
  added the optional property to the response with the status
Aug 17, 20264a6ad0ee6b5e Revision changes
- info
  endpoint added

Operation history