PUT
/
o
/
{organisation_id}
/
connections
/
{connection_id}
/
environments
/
{environment_id}

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.

environment_id
string
required

Body

application/json

EnvironmentUpdate defines the updates to apply to an existing Environment.

This supports renaming the Environment, editing variables, and updating the order and AuthSchemeConfig of each EnvironmentCredential.

id
string
required

ID is the unique identifier of the Environment. Typically this is only used internally and most (if not all) public-facing APIs will use the name in combination with the Connection's id instead.

name
string
required

Name is the new name of the Environment.

credentials
object

EnvironmentCredentialsUpdate defines the Action and Trigger credentials for the owning Connection.

Only the order and the AuthSchemeConfig of each EnvironmentCredential can be updated. To update the underlying Credential, the UpdateCredential operation should be used.

credentials.action
object[]
credentials.trigger
object[]
variables
object[]

Variables, if set, will replace the existing variables in the Environment. Setting to an empty array will delete all variables. Omitting this field will leave the existing variables unchanged.

variables.name
string
required

Name is the name of the environment variable.

variables.value
string
required

Value is the value of the environment variable.

Response

200 - application/json

Environment defines the Action and Trigger credentials for the owning Connection, and additional variables which can be used to customize the Connection in a particular environment.

id
string
required

ID is the unique identifier of the Environment. Typically this is only used internally and most (if not all) public-facing APIs will use the name in combination with the Connection's id instead.

name
string
required

Name is the name of the Environment. This must be unique within the owning Connection.

credentials
object
required

EnvironmentCredentials defines the Action and Trigger credentials for the owning Connection. If multiple credentials are defined for each type, they are applied to the request in the order they are defined. This is to enable Connections which require both a user session token and an API key to be provided in the request.

credentials.action
object[]
credentials.trigger
object[]
variables
object[]
required
variables.name
string
required

Name is the name of the environment variable.

variables.value
string
required

Value is the value of the environment variable.

createdAt
string
required

CreatedAt is the time the Environment was created.

updatedAt
string
required

UpdatedAt is the time the Environment was last updated.