Create a grant

Allow a connection to be used inside a Space. The grant lists the provider operations Skills, workflows and agents may call there, optional per-field constraints and asset boundaries. Provider operations that require a Space are called with connection_id, space_id and grant_id.

Authorization

bearerApiKey

AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128

Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

connection_id*string

Formatuuid

space_id*string

Formatuuid

allowed_operations*array<string>

Full operation keys the grant allows, in the form integrations... (for example integrations.shopify.orders.list), as listed by search_operations(provider=...) or integrations.catalog.get. Short forms such as orders.list are rejected.

safe_constraints?

asset_boundaries?

risk_acknowledgements?

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/integrations/grants" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "connection_id": "123e4567-e89b-42d3-a456-426614174000",    "space_id": "123e4567-e89b-42d3-a456-426614174000",    "allowed_operations": []  }'

{  "id": "123e4567-e89b-42d3-a456-426614174000",  "status": "ACTIVE"}

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/problem+json

401application/problem+json

402application/problem+json

403application/problem+json

404application/problem+json

405application/problem+json

409application/problem+json

410application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

502application/problem+json

503application/problem+json

504application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`