Sign in
Collection Documents

Update a document's access control list (ACL).

Update a document's ACL (access control list).

Only the document owner or an org-scoped key can modify ACL. User-scoped keys that are not the owner will receive a 403.

patch/v1/collections/{collection_identifier}/documents/{document_id}/acl

Path parameters

collection_identifierstring required

The ID of the collection.

The ID of the collection.

document_idstring required

The ID of the document.

The ID of the document.

Request body

readstring[] nullable

List of principal IDs that can read this document. Replaces existing list.

writestring[] nullable

List of principal IDs that can write this document. Replaces existing list.

publicboolean nullable

If true, any user-scoped key can read this document.

Example request

{
  "read": [
    "user_alice",
    "user_bob"
  ],
  "write": [
    "user_alice"
  ]
}

Response

Successful Response

document_idstring required

REQUIRED. Unique identifier for the document. Format: 'doc_' prefix + alphanumeric characters. Use for: API queries, references, filtering.

collection_idstring required

REQUIRED. ID of the collection this document belongs to. Format: 'col_' prefix + alphanumeric characters. Use for: Collection-scoped queries, filtering.

Example response

{
  "_internal": {
    "collection_id": "col_articles",
    "created_at": "2025-10-31T10:00:00Z",
    "document_id": "doc_f8966ff29c18e20c6b45e053",
    "internal_id": "org_abc123",
    "lineage": {
      "chain": [
        {
          "collection_id": "col_articles",
          "feature_extractor_id": "text_extractor_v1",
          "timestamp": "2025-10-31T10:00:00Z"
        }
      ],
      "path": "bkt_content/col_articles",
      "root_bucket_id": "bkt_content",
      "root_object_id": "obj_article_001",
      "source_object_id": "obj_article_001",
      "source_type": "bucket"
    },
    "metadata": {
      "ingestion_status": "COMPLETED"
    },
    "modality": "text",
    "namespace_id": "ns_xyz789",
    "source_blobs": [
      {
        "blob_id": "blob_text_001",
        "blob_property": "content",
        "blob_type": "text"
      }
    ],
    "updated_at": "2025-10-31T10:00:00Z"
  },
  "author": "Dr. Smith",
  "collection_id": "col_articles",
  "description": "Text document with _internal structure",
  "document_id": "doc_f8966ff29c18e20c6b45e053",
  "title": "AI in Healthcare"
}

Changes

Changed in 2 of the 30 revisions of this API.11

  • 1c7f318214241See the full diff
    • ●

      added the new signal enum value to the _internal/anyOf[subschema #1: InternalPayloadModel]/lineage/anyOf[subschema #1: InternalLineageModel]/source_type/anyOf[subschema #1]/ response property for the response status 200

      response-property-enum-value-added

  • 5d4c905106b41See the full diff
    • ○

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API

      api-security-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog