decks

Create Grant External

Create or update a grant on a deck.

post/decks/{deck_id}/grants

Request

  • Base URL: https://api.presentations.ai/api/v1
  • URL: https://api.presentations.ai/api/v1/decks/{deck_id}/grants
  • Auth: HTTP bearer

Path parameters

deck_idstring uuid required

Request body

subjectstring required
role'VIEW' | 'COMMENT' | 'EDIT' required

Per-deck grant role for sharing decks independently of project membership.

workspace_role'OWNER' | 'ADMIN' | 'MEMBER' | 'GUEST'

Workspace membership role; higher roles subsume lower ones for hierarchy checks.

Response

Successful Response

idstring uuid required
deck_idstring uuid required
subject_type'USER' | 'EMAIL' required

What kind of subject a deck grant targets.

subject_user_idstring uuid nullable
subject_emailstring nullable
role'VIEW' | 'COMMENT' | 'EDIT' required

Per-deck grant role for sharing decks independently of project membership.

granted_bystring uuid required
created_atstring date-time required
membership_status'member' | 'non_member' | 'pending_request' | 'invited' nullable
workspace_role'OWNER' | 'ADMIN' | 'MEMBER' | 'GUEST'

Workspace membership role; higher roles subsume lower ones for hierarchy checks.

Changes

No recorded changes to this operation across all 1 revision of this API.