Docs

Create Share

POST /documents/{documentId}/shares

POST/documents/{documentId}/shares

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Event tokenx-Event-TokenOptionalRun **Get Tokens** in the Authorization folder.

Grants a Collaborator or Crew member access to a document. Requires Admin access on the document (i.e. the EventDocumentsEdit permission).

Exactly one of collaboratorId or crewId must be provided. Sharing with a Collaborator grants access to all of their Crew members (fan-out).

Request Body

FieldTypeRequiredDescription
collaboratorIduuidOptionalCollaborator to share with. Mutually exclusive with `crewId`.
crewIduuidOptionalCrew member to share with directly. Mutually exclusive with `collaboratorId`.
permissionsstring[]RequiredAccess level(s) to grant. One or more of: `Read`, `Write`, `Admin`.

Response

201 Created with no body.