Content

Download schema

Synchronizes the current member set for one or more ACL grants owned by an authorized source.

PUT

https://api.stackinternal.com

/v1/content/acl-grant-memberships

Synchronizes the current member set for one or more ACL grants owned by an authorized source. › Request Body

Request body for synchronizing the current member set of one or more ACL grants.

PutAclGrantMembershipsV3Request

source

string · required

The registered API-managed source or authorized internal connector source that owns this ACL membership snapshot.

observedAt

string · date-time · required

The time this snapshot was observed in the upstream system.

array | null

The ACL grants to replace. Each grant is a full replacement of its current member set.

Synchronizes the current member set for one or more ACL grants owned by an authorized source. › Responses

Response body for an ACL grant membership synchronization request.

PutAclGrantMembershipsV3Response

runId

string · uuid · required

The synthetic ingestion run recorded for this request.

AclGrantMembershipSyncGrantResultResponse[] · required

Per-grant grant and revoke counts derived from the applied membership changes.

PUT/v1/content/acl-grant-memberships

curl https://api.stackinternal.com/v1/content/acl-grant-memberships \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "source": "slack-export",
  "observedAt": "2026-09-14T12:34:56+00:00",
  "grants": [
    {
      "acl": {
        "kind": "group",
        "provider": "slack",
        "identifier": "C123"
      },
      "members": [
        {
          "provider": "slack",
          "identifier": "U111"
        },
        {
          "provider": "slack",
          "identifier": "U222"
        }
      ]
    }
  ]
}'

Example Request Body

{
  "source": "slack-export",
  "observedAt": "2026-09-14T12:34:56+00:00",
  "grants": [
    {
      "acl": {
        "kind": "group",
        "provider": "slack",
        "identifier": "C123"
      },
      "members": [
        {
          "provider": "slack",
          "identifier": "U111"
        },
        {
          "provider": "slack",
          "identifier": "U222"
        }
      ]
    }
  ]
}

json

Replaces the current member sets for the supplied ACL grants.

Example Responses

{
  "runId": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
  "results": [
    {
      "acl": {
        "kind": "group",
        "provider": "slack",
        "identifier": "C123"
      },
      "observedAt": "2026-09-14T12:34:56+00:00",
      "grantedCount": 2,
      "revokedCount": 0,
      "grantedChangeSetId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
      "revokedChangeSetId": null
    }
  ]
}

json

Returns the synthetic run id and per-grant grant and revoke counts.

application/json

Creates a new content record for the authenticated tenant from a Dimension Registry archetype payload.

POST

https://api.stackinternal.com

/v1/content

Creates a new content record for the authenticated tenant from a Dimension Registry archetype payload. › Request Body

Request body for creating a new content record from a Dimension Registry archetype payload.

InsertContentV3Request

source

string · required

The upstream system that produced the content, such as 'github' or 'slack'.

sourceId

string · required

The stable identifier from the upstream system for this content item. The combination of source and sourceId must be unique within the tenant.

sourceUri

string · uri · required

The absolute URI of the content item in the upstream system.

AccessControlListGrant[] · required

The access control entries that define who can view the content.

entityType

string · required

The source-specific entity type for this content item, such as 'markdown-file' or 'message'.

ArchetypeContentEnvelope · required

Standardized archetype envelope used for transport and storage.

hierarchy

string | null · uri

The optional absolute URI-shaped container hierarchy for this content item.

array | null

Optional root-to-leaf containers with stable IDs and display names. Requires a matching hierarchy URI.

Creates a new content record for the authenticated tenant from a Dimension Registry archetype payload. › Responses

Created

Response returned when a content version is created through the public v3 content endpoint.

InsertContentV3Response

contentId

string · uuid · required

The unique identifier of the stored content version that was created.

POST/v1/content

curl https://api.stackinternal.com/v1/content \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "source": "github",
  "sourceId": "repo:octo-org/octo-repo/markdown-file:docs/README.md",
  "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
  "acls": [
    {
      "kind": "group",
      "provider": "entra",
      "identifier": "engineering-all"
    }
  ],
  "entityType": "markdown-file",
  "data": {
    "representation": "archetype",
    "representationVersion": 1,
    "archetype": "document",
    "dataSchema": "com.stackoverflow.stackinternal.content.archetype.document.v1",
    "data": {
      "title": "README",
      "textContent": "# Hello\nThis is markdown.",
      "documentType": "markdown_file",
      "personaRefs": [
        "42"
      ],
      "containerRef": "repo:octo-org/octo-repo",
      "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
      "mimeType": "text/markdown",
      "sourceVersion": "blob-sha-1"
    }
  },
  "hierarchy": "github://octo-org/octo-repo",
  "hierarchySegments": [
    {
      "id": "octo-org",
      "displayName": "Octo Org"
    },
    {
      "id": "octo-repo",
      "displayName": "Octo Repo"
    }
  ]
}'

Example Request Body

{
  "source": "github",
  "sourceId": "repo:octo-org/octo-repo/markdown-file:docs/README.md",
  "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
  "acls": [
    {
      "kind": "group",
      "provider": "entra",
      "identifier": "engineering-all"
    }
  ],
  "entityType": "markdown-file",
  "data": {
    "representation": "archetype",
    "representationVersion": 1,
    "archetype": "document",
    "dataSchema": "com.stackoverflow.stackinternal.content.archetype.document.v1",
    "data": {
      "title": "README",
      "textContent": "# Hello\nThis is markdown.",
      "documentType": "markdown_file",
      "personaRefs": [
        "42"
      ],
      "containerRef": "repo:octo-org/octo-repo",
      "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
      "mimeType": "text/markdown",
      "sourceVersion": "blob-sha-1"
    }
  },
  "hierarchy": "github://octo-org/octo-repo",
  "hierarchySegments": [
    {
      "id": "octo-org",
      "displayName": "Octo Org"
    },
    {
      "id": "octo-repo",
      "displayName": "Octo Repo"
    }
  ]
}

json

Creates one content record for a markdown document with a group ACL.

Example Responses

{
  "contentId": "cccccccc-cccc-cccc-cccc-cccccccccccc"
}

json

Returns the identifier of the stored content version that was created.

application/json

Updates an existing content record for the authenticated tenant from a Dimension Registry archetype payload.

PUT

https://api.stackinternal.com

/v1/content/{id}

A 204 response includes a Location header identifying the latest matching stored content version.

Updates an existing content record for the authenticated tenant from a Dimension Registry archetype payload. › path Parameters

id

string · uuid · required

The unique identifier for the stored content version to update.

Updates an existing content record for the authenticated tenant from a Dimension Registry archetype payload. › Request Body

Request body for updating an existing content record from a Dimension Registry archetype payload.

UpdateContentV3Request

sourceUri

string · uri · required

The absolute URI of the content item in the upstream system.

AccessControlListGrant[] · required

The access control entries that define who can view the content.

entityType

string · required

The source-specific entity type for this content item, such as 'markdown-file' or 'message'.

ArchetypeContentEnvelope · required

Standardized archetype envelope used for transport and storage.

hierarchy

string | null · uri

The optional absolute URI-shaped container hierarchy for this content item.

array | null

Optional root-to-leaf containers with stable IDs and display names. Requires a matching hierarchy URI. If omitted, stored segments are preserved only while the hierarchy path is unchanged.

Updates an existing content record for the authenticated tenant from a Dimension Registry archetype payload. › Responses

Response returned when a content version is created through the public v3 content endpoint.

InsertContentV3Response

contentId

string · uuid · required

The unique identifier of the stored content version that was created.

PUT/v1/content/{id}

curl https://api.stackinternal.com/v1/content/:id \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
  "acls": [
    {
      "kind": "group",
      "provider": "entra",
      "identifier": "engineering-all"
    }
  ],
  "entityType": "markdown-file",
  "data": {
    "representation": "archetype",
    "representationVersion": 1,
    "archetype": "document",
    "dataSchema": "com.stackoverflow.stackinternal.content.archetype.document.v1",
    "data": {
      "title": "README",
      "textContent": "# Hello\nThis is updated markdown.",
      "documentType": "markdown_file",
      "personaRefs": [
        "42"
      ],
      "containerRef": "repo:octo-org/octo-repo",
      "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
      "mimeType": "text/markdown",
      "sourceVersion": "blob-sha-2"
    }
  },
  "hierarchy": "github://octo-org/octo-repo",
  "hierarchySegments": [
    {
      "id": "octo-org",
      "displayName": "Octo Org"
    },
    {
      "id": "octo-repo",
      "displayName": "Octo Repo"
    }
  ]
}'

Example Request Body

{
  "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
  "acls": [
    {
      "kind": "group",
      "provider": "entra",
      "identifier": "engineering-all"
    }
  ],
  "entityType": "markdown-file",
  "data": {
    "representation": "archetype",
    "representationVersion": 1,
    "archetype": "document",
    "dataSchema": "com.stackoverflow.stackinternal.content.archetype.document.v1",
    "data": {
      "title": "README",
      "textContent": "# Hello\nThis is updated markdown.",
      "documentType": "markdown_file",
      "personaRefs": [
        "42"
      ],
      "containerRef": "repo:octo-org/octo-repo",
      "sourceUri": "https://github.com/octo-org/octo-repo/blob/main/docs/README.md",
      "mimeType": "text/markdown",
      "sourceVersion": "blob-sha-2"
    }
  },
  "hierarchy": "github://octo-org/octo-repo",
  "hierarchySegments": [
    {
      "id": "octo-org",
      "displayName": "Octo Org"
    },
    {
      "id": "octo-repo",
      "displayName": "Octo Repo"
    }
  ]
}

json

Updates an existing content record when the latest stored fingerprint differs.

Example Responses

{
  "contentId": "dddddddd-dddd-dddd-dddd-dddddddddddd"
}

json

Returns the identifier of the newly stored content version.

application/json

Deletes an existing content record for the authenticated tenant.

DELETE

https://api.stackinternal.com

/v1/content/{id}

Deletes an existing content record for the authenticated tenant. › path Parameters

id

string · uuid · required

The unique identifier for the stored content version to delete.

Deletes an existing content record for the authenticated tenant. › Responses

Returns when the content exists and is deleted.

No data returned

Audit events Knowledge