GET
/
connections
/
oauth2
/
callback
curl --request GET \
  --url https://platform.versori.com/api/switchboard/v1alpha1/connections/oauth2/callback \
  --header 'Authorization: <api-key>'
{
  "id": "<string>",
  "organisationID": "<any>",
  "name": "<string>",
  "data": {},
  "type": "<string>",
  "redactFields": [
    "<string>"
  ],
  "expiresAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
code
string

The authorization code to exchange for an access token.

​
state
string

This value is generated by the /organisations/{organisationId}/connection-init operation and is an opaque string and should have no meaning to external clients. Internally, it's used to verify the flow was initialised by Switchboard and connect the authorisation grant to the user/organisation who initiated it.

​
error
string

An error code by the OAuth2.0 provider indicating a problem occurred during the grant.

​
error_description
string

A human-readable error message associated to the error code specified in the error parameter.

Response

201
application/json

CreateCredentialResponse is the response containing the new credential.

Credential holds sensitive data not owned by Versori. Users can create credentials so that Versori systems can authenticate to external services on behalf of the user.