Workspaces

Manage organizational units (“workspaces”) that group social accounts, members, and content. Workspaces help agencies, brands, and departments keep clients and campaigns separate under a single Publer login.

Requirements

• Authentication: Bearer API token

• Scope: workspaces

• Headers:

  • Authorization: Bearer-API YOUR_API_KEY

Endpoint

List Workspaces

Retrieve all workspaces accessible by the authenticated user.

GET /api/v1/workspaces

List Workspaces

get

Retrieves a list of all workspaces that the authenticated user has access to.

Authorizations

BearerApiAuth

AuthorizationstringRequired

API key authentication. Format: "Bearer-API YOUR_API_KEY"

Responses

200

Successful operation

application/json

idstringOptional

Unique identifier for the workspace

Example: 61a7c2e4f9e8c3b2d1e0f9a8

namestringOptional

The workspace's display name

Example: Marketing Team

membersobject[]Optional

List of users with access to the workspace

planstringOptional

Subscription plan of the workspace

Example: business

picturestringOptional

URL to the workspace's logo

Example: https://publer-dev.s3.amazonaws.com/uploads/logos/marketing_team_logo.png

401

Unauthorized

application/json

403

Permission denied or missing required scope

application/json

get

/workspaces

HTTPcURLJavaScriptPython

GET /api/v1/workspaces HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "61a7c2e4f9e8c3b2d1e0f9a8",
    "owner": {
      "id": "5b1ec026db27977424e8599e",
      "email": "[email protected]",
      "name": "ervintorra",
      "first_name": "Ervin",
      "picture": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_mini_magick20250123-28707-otuw0w.png"
    },
    "name": "Marketing Team",
    "members": [
      {}
    ],
    "plan": "business",
    "picture": "https://publer-dev.s3.amazonaws.com/uploads/logos/marketing_team_logo.png"
  }
]

Working with Workspaces

• A user can belong to multiple workspaces.

• Each workspace has its own accounts, posts, and settings.

• Use the workspace context (Publer-Workspace-Id header) to target API calls at the correct workspace.

Workspace Context for Other Endpoints

Many endpoints require you to specify which workspace you’re operating in. Include the Publer-Workspace-Id header:

curl -X GET https://app.publer.com/api/v1/accounts \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Publer-Workspace-Id: 61a7c2e4f9e8c3b2d1e0f9a8"

Related Resources

• Users API - Access user profile information

• Accounts API - Access social accounts within workspaces

• Posts API — Create, schedule, and manage content