app-listings

Start an app listing OAuth install

Return the provider OAuth authorize URL for connecting an app listing.

post/app-listings/install/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/app-listings/install/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

inputsobject

Connect-time inputs collected before the redirect (tenant address, region, or a choice), keyed by input name. Empty for listings that need no inputs.

integration_idstring uuid nullable

For switch/reconnect only: the existing integration to re-authorize in place. Bound into the OAuth state so the claim mutates only this integration. Omit for new connects.

intent'switch' | 'reconnect'

Why an OAuth grant is being captured against an existing integration.

Set on an installation whose grant re-authorizes a connection in place rather than creating a new one. None on a normal new-connect install.

slugstring required

Response

Successful Response

authorize_urlstring required

Changes

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