| Property | Value |
|---|---|
| Auth | Required |
| Idempotent | Yes (duplicate requests for the same scope return the existing pending request) |
Path
| Field | Required | Notes |
|---|---|---|
provider | yes | The integration provider key (e.g., github, linear). |
Body
| Field | Type | Required | Notes |
|---|---|---|---|
scope | read | write | yes | The scope being requested. |
reason | string | no | Free text. Surfaces in the approval email. |
Errors
| Status | Code | When |
|---|---|---|
| 401 | AUTH_REQUIRED | No session. |
| 404 | Provider not connected on this account | No integration of this provider exists yet. |
| 500 | INTERNAL_ERROR | Write or email failed. |
credential_requests, email sent to the integration owner via Resend.