Platform API reference

Platform API · Oauth-Authorization-Server

get/v1/oauth/workspaces/{workspace_id}/connectionsAuth

List every client connected to a workspace

The workspace-side half of revocation, for owners and admins: every grant made against this workspace, by any member, including grants made by people who have since left. Requires `workspace.connection.read`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Query parameters

limitinteger

Page size. Defaults to 20, clamped to 100.

cursorstring

Opaque `next_cursor` from the previous page.

Response · 200 Page of connections, newest first, with `next_cursor` and `has_more`.

data*array

One page of connected apps.

pagination*object
next_cursor*string

Pass as `cursor` to get the next page; `null` on the last page.

Example: null

has_more*boolean

Whether another page follows this one.

Example: false

Example

Request

GET https://api.platform-auth.productcraft.co/v1/oauth/workspaces/{workspace_id}/connections
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "grant_id": "00000000-0000-0000-0000-000000000000",
      "client_id": "string",
      "client_name": "string",
      "is_verified": false,
      "account_id": "00000000-0000-0000-0000-000000000000",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "preset": "mail",
      "policy": [
        {
          "effect": "allow",
          "actions": [
            "social.read",
            "social.list"
          ],
          "resources": [
            "*"
          ]
        }
      ],
      "resource": "string",
      "products": [
        "mail"
      ],
      "first_tool_call_at": "2026-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "revoked_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false
  }
}