PUT
/
o
/
{organisation_id}
/
connections
/
{connection_id}
curl --request PUT \
  --url https://platform.versori.com/api/connect/v1alpha1/o/{organisation_id}/connections/{connection_id} \
  --header 'Content-Type: application/json' \
  --data '{
  "authSchemeConfigs": [
    {
      "schemeType": "<string>"
    }
  ],
  "environments": [
    {
      "credentials": {
        "action": [
          {
            "authSchemeConfig": {
              "schemeType": "<string>"
            },
            "id": "<string>"
          }
        ],
        "trigger": [
          {
            "authSchemeConfig": {
              "schemeType": "<string>"
            },
            "id": "<string>"
          }
        ]
      },
      "id": "<string>",
      "name": "<string>",
      "variables": [
        {
          "name": "<string>",
          "value": "<string>"
        }
      ]
    }
  ],
  "id": "<string>",
  "name": "<string>",
  "organisationId": "<string>",
  "protocol": "http",
  "baseUrl": "<string>",
  "environmentVariables": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ]
}'
{
  "authSchemeConfigs": [
    {
      "schemeType": "<string>"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "environmentVariables": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "environments": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "credentials": {
        "action": [
          {
            "authSchemeConfig": {
              "schemeType": "<string>"
            },
            "credential": {
              "createdAt": "2023-11-07T05:31:56Z",
              "data": {},
              "errors": [
                "<string>"
              ],
              "id": "<string>",
              "name": "<string>",
              "type": "none",
              "updatedAt": "2023-11-07T05:31:56Z",
              "usages": [
                {
                  "environment": {
                    "connection": {
                      "createdAt": "2023-11-07T05:31:56Z",
                      "id": "<string>",
                      "name": "<string>",
                      "organisationId": "<string>",
                      "protocol": "http",
                      "updatedAt": "2023-11-07T05:31:56Z"
                    },
                    "createdAt": "2023-11-07T05:31:56Z",
                    "id": "<string>",
                    "name": "<string>",
                    "slug": "<string>",
                    "updatedAt": "2023-11-07T05:31:56Z"
                  }
                }
              ]
            },
            "id": "<string>"
          }
        ],
        "trigger": [
          {
            "authSchemeConfig": {
              "schemeType": "<string>"
            },
            "credential": {
              "createdAt": "2023-11-07T05:31:56Z",
              "data": {},
              "errors": [
                "<string>"
              ],
              "id": "<string>",
              "name": "<string>",
              "type": "none",
              "updatedAt": "2023-11-07T05:31:56Z",
              "usages": [
                {
                  "environment": {
                    "connection": {
                      "createdAt": "2023-11-07T05:31:56Z",
                      "id": "<string>",
                      "name": "<string>",
                      "organisationId": "<string>",
                      "protocol": "http",
                      "updatedAt": "2023-11-07T05:31:56Z"
                    },
                    "createdAt": "2023-11-07T05:31:56Z",
                    "id": "<string>",
                    "name": "<string>",
                    "slug": "<string>",
                    "updatedAt": "2023-11-07T05:31:56Z"
                  }
                }
              ]
            },
            "id": "<string>"
          }
        ]
      },
      "id": "<string>",
      "name": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "variables": [
        {
          "name": "<string>",
          "value": "<string>"
        }
      ]
    }
  ],
  "id": "<string>",
  "name": "<string>",
  "organisationId": "<string>",
  "protocol": "http",
  "updatedAt": "2023-11-07T05:31:56Z",
  "versions": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "id": "<string>",
      "isDefault": true,
      "isLatest": true,
      "name": "<string>",
      "publishedAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "baseUrl": "<string>"
}

Authorizations

cookie
string
cookierequired

Cookie authentication used by the Versori Platform.

Path Parameters

organisation_id
string
required
connection_id
string
required

ID is the unique identifier of the Connection.

Body

application/json
  • Option 1

  • Option 2

authSchemeConfigs
object[]

AuthSchemeConfigs, if set, will overwrite the existing list of auth scheme configs with the provided array. This will not affect any existing Environments since they store a copy of the Auth Scheme on creation. In order to update an Environment with an updated Auth Scheme, the user should update the Credential directly.

  • Option 1

  • Option 2

  • Option 3

  • Option 4

  • Option 5

  • Option 6

environments
object[]

Environments, if set, will overwrite the existing list of environments with the provided array. This array can only specify existing environments (without edits) or new environments. This is useful for replacing an existing Environment with a new one, or reordering. It's recommended to use the UpdateEnvironment operation to update a single environment.

  • Option 1

  • Option 2

id
string
required

ID is the unique identifier of the Connection.

name
string
required

Name is the user-provided name of the Connection

organisationId
string
required

OrganisationID is the unique identifier of the Organisation that owns the Connection.

protocol
enum<string>
required

ProtocolType denotes the set of all valid connection types.

Available options:
http,
bigquery
baseUrl
string
required

BaseURL is the base URL of all HTTP Actions within the Connection.

environmentVariables
object[]

EnvironmentVariables, if set, will overwrite the existing list of environment variables or create new ones with the provided array. This action will be performed on all the connection environments as well.

Response

200 - application/json
  • Option 1

  • Option 2

authSchemeConfigs
object[]
  • Option 1

  • Option 2

  • Option 3

  • Option 4

  • Option 5

  • Option 6

createdAt
string
required

CreatedAt is the time at which the ConnectionVersion was created.

environmentVariables
object[]

Environment Variables is a list of default variables initialised in every connection environment.

environments
object[]
required

Environments is a list of all the environments this Connection has.

id
string
required

ID is the unique identifier of the Connection.

name
string
required

Name is the user-provided name of the Connection

organisationId
string
required

OrganisationID is the unique identifier of the Organisation that owns the Connection.

protocol
enum<string>
required

ProtocolType denotes the set of all valid connection types.

Available options:
http,
bigquery
updatedAt
string
required

UpdatedAt is the time at which the ConnectionVersion was last updated, including any changes to child resources.

versions
object[]

Versions is a list of all the versions this Connection has.

baseUrl
string
required

BaseURL is the base URL of all HTTP Actions within the Connection.