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/contentWorkspace-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
| 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 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.