Skip to content

Workspaces ​

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 ​

An API key belongs to exactly one workspace, and every request made with it acts on that workspace:

typescript
const socifyr = new Socifyr({ apiKey: 'sk_...' })
bash
curl -H "Authorization: Bearer sk_..." \
     https://api.socifyr.com/api/content

Workspace-scoped routes accept current in place of the ID, for example GET /api/workspaces/current/connections. To work in another workspace (another brand or client), use that workspace's key. See multiple brands or clients.

Roles ​

RoleCan edit contentCan publishCan manage membersCan manage billing
Owner✓✓✓✓
Admin✓✓✓—
Editor✓✓——
Contributor✓ (own drafts)———

See the Workspaces SDK for member management.

Tier limits ​

Workspaces are on one of four plans: Free, Creator, Team and Agency. The API reports them by plan ID in tier: free, pro (Creator), business (Team) and agency. Each tier has limits on posts/month, scheduled posts, connected accounts and X posts. See limits or pricing for the current breakdown.