Reserve an authenticated partner upload session. Requires a single-org solution_company_upload service-account credential and a stable Idempotency-Key.

post/api/v1/organizations/{org_id}/partner-uploads/initiate

Request

  • Base URL: https://api.basecite.com
  • URL: https://api.basecite.com/api/v1/organizations/{org_id}/partner-uploads/initiate
  • Auth: none declared. Required headers: Idempotency-Key

Headers

Idempotency-Keystring required

Stable replay key for a single mutation request.

Request body

filenamestring required
content_typestring required
size_bytesinteger required
notesstring
material_typestring
importance'normal' | 'important'

Example request

{
  "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "consent": {
    "beta_agreement_version": "controlled-launch-2026-06-19",
    "ai_readable_use_consent_version": "ai-readable-use-2026-06-19"
  }
}

Response

Multipart upload reserved; response includes upload_id and part_size_bytes

request_idstring
trace_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.