GoRunner docs
Search or askSearch⌘K

List accounts

GET/api/embed/v1/accounts

Returns a page of your customers’ accounts, newest 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

Query

statusOptional · string

active, suspended or deleted.

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.

Responses

  • 200OK

    A page of accounts.

  • 400VALIDATION_ERROR

    A parameter isn’t valid. details.field names it.

  • 500INTERNAL_ERROR

    Something failed on the installation’s side. Try again.

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_…

URL="$GORUNNER/api/embed/v1/"
URL="${URL}accounts?status=active&limit=50"
curl "$URL" \
  -H "Authorization: Bearer $GORUNNER_EMBED_KEY"

Response · 200 OK

json
{
  "data": [
    {
      "id": "acct-bakery",
      "name": "Bakery Ltd",
      "status": "active",
      "turnOff": [],
      "pieces": null,
      "assistant": {
        "monthlyTokens": null
      },
      "limits": {
        "concurrentRuns": null
      },
      "workspaces": 2,
      "members": 5,
      "suspendedAt": null,
      "suspendedReason": null,
      "deletedAt": null,
      "purgeAfter": null,
      "createdAt": "2026-10-20T08:00:00Z",
      "updatedAt": "2026-10-25T09:00:00Z",
      "organizationId": "e9d2b6f1-3a7c-4d05-b8e4-1c6f2a9d7b30",
      "aiSignIn": {
        "address": null
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "nextCursor": null
  }
}
Every field

It takes no body.

Response · 200 OK

dataarray of objects
idstring
namestring
statusstring

One of active, suspended, deleted.

turnOffarray of strings
piecesarray of strings or null

Null inherits the installation’s list.

assistantobject
monthlyTokensinteger or null
limitsobject
concurrentRunsinteger or null

How many runs this account may have executing at once. Null = the installation’s default (Platform › Settings › General), 0 = no limit. Runs over it wait in line and start in order; none is refused for it.

workspacesinteger
membersinteger

Distinct people with access.

suspendedAttime or null
suspendedReasonstring or null
deletedAttime or null
purgeAftertime or null
createdAttime
updatedAttime
organizationIdUUID

The installation’s own id, for support.

aiSignInobject
addressURL or null

This account’s own AI app sign-in address: where an AI app’s sign-in sends this account’s people instead of the installation’s address. Null: they go to the installation’s address (Platform › What customers get › Developers). It is used only while its website is still one of the installation’s allowed websites or one of this account’s own; otherwise the installation’s address is used, or, when the installation has none, no AI app can sign in to the account (mcp.signInFrom says which).

mcpobject or null

Only on GET /accounts/{accountId}: the account’s MCP addresses as its people find them on the MCP page. Null while Tokens or MCP is off for the account, or it is deleted. While an AI app can sign in to it (AI app sign-in on, and a sign-in address to send its people to: the account’s own aiSignIn.address or the installation’s), they are the account’s own addresses and signIn is true; otherwise the plain addresses tokens use.

buildURL or null

The address that builds and manages workflows; null while MCP building (mcpBuild) is off.

toolsURL

The address that calls the published workflows.

signInboolean

Whether an AI app can connect by signing in: through the account’s own aiSignIn.address while its website is allowed, or the installation’s AI app sign-in address.

signInFromstring or null

Whose address a sign-in uses: account (its own aiSignIn.address) or installation; null when signIn is false. installation while aiSignIn.address is set means its website is no longer allowed for the account.

One of account, installation, null.

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.