Connections

Assign an authorized account

Owner user credentials only. Assigns a sanitized provider authorization to one AI, Listing, or transaction without exposing credentials. Request-only assignments must expire within 24 hours; saved assignments require explicit consent.

post/ais/{aiId}/connections/{connectionId}/assignments

Request

  • Base URL: https://api.darwin.so/api/v1
  • URL: https://api.darwin.so/api/v1/ais/{aiId}/connections/{connectionId}/assignments
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

aiIdstring required
connectionIdstring required

Request body

targetKind'AI' | 'LISTING' | 'TRANSACTION' required
targetIdstring required
retention'REQUEST_ONLY' | 'SAVED_WITH_CONSENT' required
scopesstring[] required
expiresAtstring date-time
consentedboolean

Must be true for SAVED_WITH_CONSENT after the user completes Darwin-hosted consent.

Response

The scoped account assignment.

Changes

No recorded changes to this operation across all 1 revision of this API.