Get your workspace

The workspace your API key acts on, with your plan.

Last checked against the API October 10, 2026 · View as Markdown

GEThttps://studio.postprism.app/api/v1/workspace

Returns the workspace your API key was created in, which is the default for every other endpoint, and your Postprism plan.

Example

Get your workspace
curl "https://studio.postprism.app/api/v1/workspace" \
  -H "Authorization: Bearer pp_live_your_api_key"

Response

200. data is a WorkspaceInfo. The workspace your API key acts on by default.

workspace_iduuid

The workspace ID.

namestringnullable

The workspace name.

planstring

Your Postprism plan. One of: solo, freelancer, agency.

200 response
{
  "data": {
    "workspace_id": "7b2d4e6f-0000-4000-8000-00000000b001",
    "name": "Juniper Roasters",
    "plan": "freelancer"
  },
  "error": null
}

Errors

StatusMessageWhen
401Invalid or revoked API keyThe Authorization header is missing, malformed, or the key was revoked.
429Too many requestsYou went over the hourly limit. See Rate limits.
PreviousList connected platformsNextList workspaces