Cloud Access

Create or replace a cloud access connection

Saves the workspace's one connection for a provider (aws, gcp or azure). Requires owner/admin. config is required and replaces the stored config; a changed config clears the last test. enabled and allowed_triggers keep their stored values when omitted; a new connection is enabled and allows manual and api. A connection signs in only runs whose trigger it allows: manual sessions started in the reason app; api sessions started with the api, the cli or by another session; schedule scheduled automations; github_event github mentions, issues and pull requests; webhook automation webhooks; slack slack mentions; linear linear issues.

<sub>Scope: org:write</sub>

put/v3/organizations/{orgId}/cloud-access/{provider}

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/cloud-access/{provider}
  • Auth: HTTP bearer

Request body

configobject required

Provider identifiers, as in the connection.

enabledboolean
allowed_triggersstring[]

Response

The saved connection.

provider'aws' | 'gcp' | 'azure' required
configobject required

Provider identifiers: aws role_arn, region; gcp workload_identity_provider, service_account, project_id; azure tenant_id, client_id, subscription_id.

enabledboolean required
allowed_triggersstring[] required

Run triggers this connection signs in.

updated_atstring date-time required
last_tested_atstring date-time nullable
last_test_okboolean nullable
last_test_messagestring nullable
last_used_atstring date-time nullable

Changes

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