---
title: "Accept customer or delegated-uploader submitted artifacts with required consent capture and non-evaluation labels."
method: POST
path: "/api/v1/organizations/{org_id}/customer-uploads"
---

# Accept customer or delegated-uploader submitted artifacts with required consent capture and non-evaluation labels.

`POST /api/v1/organizations/{org_id}/customer-uploads`

## Request

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

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `filename` string, required
  - `content_type` string
  - `visibility` 'ai_readable_controlled' | 'private_summary_public' | 'internal_only' | 'public_profile', required
  - `payload` string, required
  - `uploader_organization_type` 'customer' | 'solution_company' | 'third_party'
  - `uploader_organization_id` string
  - `asserted_subject_org_id` string
  - `customer_workspace_access` 'granted' | 'not_granted'
  - `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 `201`

Upload accepted as non-evaluated provenance record with redacted consent_capture status

- CreateCustomerUploadResponse
  - `request_id` string
  - `trace_id` string
  - `data` object
    - `upload_id` string
    - `org_id` string
    - `status` string
    - `filename` string
    - `consent_capture` object

## Other responses

- `400`: Invalid upload, missing/invalid consent, or forbidden verification claim
- `403`: Workspace access boundary blocks customer canonical write

---

[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)