List Workspaces

curl --request GET \
  --url https://www.genviral.io/api/partner/v1/workspaces \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Workspaces retrieved",
  "data": [
    {
      "selector": "personal",
      "kind": "personal",
      "name": "Personal space"
    },
    {
      "selector": "bbf64a28-a2fd-48f4-88ef-bf7480f18402",
      "kind": "workspace",
      "name": "Acme Studio"
    }
  ]
}

GET

api

partner

workspaces

curl --request GET \
  --url https://www.genviral.io/api/partner/v1/workspaces \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Workspaces retrieved",
  "data": [
    {
      "selector": "personal",
      "kind": "personal",
      "name": "Personal space"
    },
    {
      "selector": "bbf64a28-a2fd-48f4-88ef-bf7480f18402",
      "kind": "workspace",
      "name": "Acme Studio"
    }
  ]
}

Returns every tenancy the presented credential may act in. An API key is pinned at issue time and returns exactly one entry. An MCP OAuth connection returns whatever its grant covers: one tenancy for a pinned grant, or the personal space plus every team workspace the connected account can reach for an all-access grant. Use a returned selector as the X-Genviral-Workspace header on later calls to run that request in the named tenancy.

Response

string

The exact value to send in X-Genviral-Workspace: personal, or a workspace ID.

string

personal or workspace.

string

Display name for the tenancy.

curl --request GET \
  --url https://www.genviral.io/api/partner/v1/workspaces \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Workspaces retrieved",
  "data": [
    {
      "selector": "personal",
      "kind": "personal",
      "name": "Personal space"
    },
    {
      "selector": "bbf64a28-a2fd-48f4-88ef-bf7480f18402",
      "kind": "workspace",
      "name": "Acme Studio"
    }
  ]
}

Targeting a tenancy

Send the selector on any endpoint. The header may only narrow a credential to a tenancy it already covers, never widen it.

cURL

curl --request GET \
  --url https://www.genviral.io/api/partner/v1/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Genviral-Workspace: bbf64a28-a2fd-48f4-88ef-bf7480f18402'

Omitting the header uses the credential’s own default: its pinned tenancy, or the personal space for an all-access MCP grant.

Error Responses

401 - authentication failed
403 - tenancy_not_granted: the credential may not act in the named tenancy

Get Subscription Get Analytics Summary

Getting Started

Accounts

Posts

Files

Folders

Studio AI

Slideshows

Trends

Packs

Templates

Response

Targeting a tenancy

Error Responses

​Response

​Targeting a tenancy

​Error Responses

Response

Targeting a tenancy

Error Responses