Skip to main content
POST
Request a new integration grant

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id
string<uuid>
required

UUIDv7 of the workspace.

fleet_id
string<uuid>
required

UUIDv7 of the fleet.

Body

application/json
service
enum<string>
required
Available options:
slack,
gmail,
agentmail,
discord,
grafana
reason
string
required

Response

Existing grant returned (idempotent — a pending or approved grant for this service already existed).

grant_id
string<uuid>
status
enum<string>
Available options:
pending,
approved
fleet_id
string<uuid>
service
string
requested_at
integer<int64>
message
string