Core Concepts
Organizations
How API keys map to organizations, and the role model behind them.
An organization is the top of Dynamo's data hierarchy: every channel, post, workspace, and superpower belongs to exactly one org.
One key, one org
An API key pair (key + secret) is scoped to a single organization. Every read and
write you make is automatically confined to that org — there's no cross-org access and
no orgId to pass. To act on a different organization, use that org's key.
Discovering your organization
Use GET /organizations to confirm which organization a key resolves to — handy for
labeling and sanity checks.
sign; curl -s $(H) "$BASE/organizations"See GET /organizations.
Roles
Members of an organization have one of three roles:
| Role | Capabilities |
|---|---|
VIEWER | Read-only access. |
EDITOR | Create and edit content (drafts, scheduled posts). |
ADMIN | Full access, including organization settings. |
API-key callers act with ADMIN privileges within their organization.