Every Socifyr API call happens inside a workspace. A workspace owns:

• Connections to social accounts (one workspace can connect many Instagram pages, LinkedIn profiles, etc.)
• Content — drafts, scheduled posts, history
• Media library items
• API keys
• Members with role-based permissions

Choosing a workspace

Each request must specify a workspace. The SDK takes it once at construction time; the API takes it via the X-Workspace-Id header:

const socifyr = new Socifyr({
  apiKey: 'sk_...',
  workspaceId: '69fbbf978e770da397a59a5a',
})

curl -H "X-Workspace-Id: 69fbbf978e770da397a59a5a" \
     -H "Authorization: Bearer sk_..." \
     https://api.socifyr.com/api/content

If you omit X-Workspace-Id, the API falls back to the first workspace the API key has access to.

Roles

Role	Can edit content	Can publish	Can manage members	Can manage billing
Owner	✓	✓	✓	✓
Admin	✓	✓	✓	—
Editor	✓	✓	—	—
Contributor	✓ (own drafts)	—	—	—

See the Workspaces SDK for member management.

Tier limits

Workspaces are on one of three tiers: free, pro, business. Each tier has limits on posts/month, scheduled posts, and connected accounts. See pricing for the current breakdown.