Skip to main content
GET
List grant contexts

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

toolkit_slug
string
required

Toolkit to list grant contexts for.

Minimum string length: 1

Query Parameters

auth_scheme
enum<string>
default:OAUTH2

Auth scheme the connection will use. Defaults to OAUTH2.

Available options:
OAUTH2,
OAUTH1,
API_KEY,
BASIC,
BILLCOM_AUTH,
BEARER_TOKEN,
GOOGLE_SERVICE_ACCOUNT,
NO_AUTH,
BASIC_WITH_JWT,
CALCOM_AUTH,
SERVICE_ACCOUNT,
SAML,
DCR_OAUTH,
CIMD_OAUTH,
S2S_OAUTH2
toolkit_version
string
default:latest

Toolkit version to read the catalog from; defaults to the latest published version. Pass a concrete version to pin.

Minimum string length: 1

Response

Successfully discovered the toolkit's grant-context dimensions

auth_scheme
string
required

Auth scheme whose scope catalog the vocabulary was read from.

toolkit_version
string
required

Concrete toolkit version the answer was computed from; pass it back as toolkit_version to pin.

grant_context_dimensions
object[]
required

Dimensions this toolkit accepts in grant_context under the auth scheme; [] when no scope depends on grant_context.

default_grant_context
object
required

The grant_context assumed when you pass none — pass a dimension and its selected value only to override or extend it.