GoRunner docs
Search or askSearch⌘K

List workspaces

GET/api/embed/v1/accounts/{accountId}/workspaces

Lists an account’s workspaces, the default one first.

Needs a partner key: Authorization: Bearer gre_…, from Platform › Partner keys. Call it from your server only.

Embed · Self-hosted with an Embed license

Parameters

Path

accountIdRequired · string

Your ID for the customer’s account: 1 to 255 bytes of UTF-8, case-sensitive. URL-encode it: it may contain /.

Query

cursorOptional · string

The pagination.nextCursor of the page before. Left out: the first page.

limitOptional · integer

Rows a page, 1 to 100. The default is 50.

Two IDs

id is yours; the default workspace has none (null). workspaceId is GoRunner’s, for support.

Responses

Any call can also answer: 401 UNAUTHORIZED · 403 EMBED_NOT_LICENSED · 403 IP_NOT_ALLOWED · 429 RATE_LIMITED · 503 BUSY. See Errors.

Request

GORUNNER="https://automations.example.com"
GORUNNER_EMBED_KEY="YOUR_PARTNER_KEY"  # gre_…
ACCOUNT_ID="acct-bakery"

URL="$GORUNNER/api/embed/v1/accounts/$ACCOUNT_ID/"
URL="${URL}workspaces"
curl "$URL" \
  -H "Authorization: Bearer $GORUNNER_EMBED_KEY"

Response · 200 OK

json
{
  "data": [
    {
      "id": null,
      "default": true,
      "name": "Default Workspace",
      "members": 4,
      "createdAt": "2026-10-20T08:00:00Z",
      "workspaceId": "c41a7e02-9b3d-4f6a-8e15-7d2c0b9a4f68"
    },
    {
      "id": "ws-orders",
      "default": false,
      "name": "Orders",
      "members": 2,
      "createdAt": "2026-10-22T10:00:00Z",
      "workspaceId": "6e9a1c3f-8b2d-4a57-9e0c-3f7b5d1a8c42"
    }
  ],
  "pagination": {
    "limit": 50,
    "nextCursor": null
  }
}
Every field

It takes no body.

Response · 200 OK

dataarray of objects
idstring or null

The partner’s workspace id; null for the default workspace.

defaultboolean
namestring
membersinteger
createdAttime
workspaceIdUUID

The installation’s own id of the workspace, for support. Elsewhere workspaceId is the partner’s id (id here).

paginationobject
limitinteger
nextCursorstring or null

The cursor of the next page; null on the last page. A page that comes back full can carry a cursor even when nothing follows: the next page is then empty, with null here. Keep going until it is null.