Request integration access

Request access to a teammate’s integration credentials. Used when the credential request flow needs to span an OAuth boundary (e.g., the GitHub admin owns the connection, and the requesting member needs read scope to feed scoring).

curl -X POST https://app.dacard.ai/api/integrations/github/request-access \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "read",
    "reason": "Need to fold our deploy frequency into the next score."
  }'

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.

Side effects: row inserted in credential_requests, email sent to the integration owner via Resend.

Overview

Scoring

Score drilldown

Lifecycle

Products

Teams

Dashboard & Suite

Account & Team

User

Onboarding

Billing

Internal

Agents

Integrations

BYOM

Intelligence

Decisions & Briefings

Saved views

Recommendations

Tribal notes

Credentials

Signals

Anomalies

Outcomes

Feedback

Settings

Webhooks

API Keys

Misc

System

Request integration access

Path

Body

Errors

​Path

​Body

​Errors

Path

Body

Errors