User Provider Identity

Start an OAuth device flow to link a provider identity

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

providerstring · enumRequired

Provider to link a user identity for

Possible values:

sourcestring · enumOptional

Originating client surface (attribution only)

Possible values:

Responses

403

Forbidden - Requires role: owner, member

No content

post/sfp/api/user/provider-identity/device/start

POST /sfp/api/user/provider-identity/device/start HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "provider": "github",
  "source": "web-device"
}

403

Forbidden - Requires role: owner, member

No content

Poll a device flow; links the identity on success

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

flowIdstringRequired

The flow_id returned by device/start

sourcestring · enumOptional

Originating client surface (attribution only)

Possible values:

Responses

403

Forbidden - Requires role: owner, member

No content

post/sfp/api/user/provider-identity/device/poll

POST /sfp/api/user/provider-identity/device/poll HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "flowId": "text",
  "source": "web-device"
}

403

Forbidden - Requires role: owner, member

No content

List the caller's linked provider identities

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

403

Forbidden - Requires role: owner, member

No content

get/sfp/api/user/provider-identity

GET /sfp/api/user/provider-identity HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

403

Forbidden - Requires role: owner, member

No content

Revoke a linked provider identity

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

403

Forbidden - Requires role: owner, member

No content

delete/sfp/api/user/provider-identity/{id}

DELETE /sfp/api/user/provider-identity/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

403

Forbidden - Requires role: owner, member

No content

Force a token refresh for a linked identity (debug / reconnect)

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

403

Forbidden - Requires role: owner, member

No content

post/sfp/api/user/provider-identity/{id}/refresh

POST /sfp/api/user/provider-identity/{id}/refresh HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

403

Forbidden - Requires role: owner, member

No content