---
title: "Reserve an authenticated partner upload session. Requires a single-org solution_company_upload service-account credential and a stable Idempotency-Key."
method: POST
path: "/api/v1/organizations/{org_id}/partner-uploads/initiate"
---

# 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-Key` string, required

## Request body

- object
  - `filename` string, required
  - `content_type` string, required
  - `size_bytes` integer, required
  - `notes` string
  - `material_type` string
  - `importance` 'normal' | 'important'
  - `consent` object, required
    - `accepted` true, required
    - `beta_agreement_version` string, required
    - `ai_readable_use_consent_version` string, required
    - `text_hash_sha256` string, required
    - `consenting_user_id` string, required
    - `consenting_user_email` string, email, required
    - `accepted_at` string, date-time, required

## Response `200`

Multipart upload reserved; response includes upload_id and part_size_bytes

- InitiatePartnerUploadResponse
  - `request_id` string
  - `trace_id` string
  - `data` object
    - `upload_id` string, required
    - `part_size_bytes` integer, required
    - `status` string
    - `expires_at` string, date-time

## Other responses

- `401`: A properly bound partner service-account credential is required
- `409`: Idempotency key replay or conflict

---

[API](https://skmtc.dev/basecite/apis/basecite-stable-ai-context-api.md) · [All operations](https://skmtc.dev/basecite/apis/basecite-stable-ai-context-api/llms.txt) · [OpenAPI document](https://skmtc.dev/basecite/apis/basecite-stable-ai-context-api/revisions/2a269a68ba07?raw)