Organization API
Manage your organization, API keys, templates, analytics, and team members
The Organization API lets you manage every aspect of your Pocket organization — API keys, shared templates, analytics, recordings, members, and invites.
Base Path
All organization endpoints are scoped under:
/api/v1/organization/:orgId/Replace :orgId with your organization's unique identifier.
Authentication
Organization endpoints accept two authentication methods:
| Method | Header | Use Case |
|---|---|---|
| Firebase token | Authorization: Bearer <firebase_id_token> | Internal apps and admin dashboards |
| Organization API key | Authorization: Bearer pk_xxx | Programmatic / public API access |
Firebase-authenticated requests resolve the caller's org membership and role automatically. API-key requests inherit the scopes assigned to the key.
Permission Model
Every organization member has one of four roles:
| Role | Description |
|---|---|
owner | Full control including billing and org deletion |
admin | Manage members, keys, templates, and recordings |
viewer | Read-only access to recordings, analytics, and templates |
member | Standard access to recordings and templates |
Endpoints note their minimum required role. Actions that modify resources (create, update, delete) typically require admin or above; read-only actions are available to viewer and above.