Plane docs
API referenceEndpointsConnections

connections.grants.list

POST
/v1/connections/grants/list

RPC connections.grants.list · Scope read

AuthorizationBearer <token>

A Plane API key, pl_<env>_…. The key is the environment: everything it reads and writes is scoped to the environment it was minted in, and the two tenancy headers are ignored for one.

In: header

Header Parameters

x-plane-environment?string

The environment slug this request is about. Honoured only for a session cookie; ignored for an API key, whose environment is its identity.

x-plane-organization?string

The organization slug or id this request is about, resolved before the environment. Honoured only for a session cookie.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/connections/grants/list" \  -H "Content-Type: application/json" \  -d '{}'
[  {    "id": "string",    "connectionId": "string",    "connection": "string",    "identity": {      "scope": "string",      "id": "string",      "display": "string",      "attributes": {}    },    "resource": "string",    "issuer": "string",    "scopes": [      "string"    ],    "status": "active",    "error": "string",    "hasRefreshToken": true,    "expiresAt": "string",    "createdAt": "string",    "updatedAt": "string",    "lastUsedAt": "string"  }]