list-cloudflow-connections

dci list-cloudflow-connections [flags]

Returns a cursor-paginated list of cloud provider connections for the authenticated tenant.

Flags

--max-results: (integer default:50)

--page-token: (string)

Output

By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.

Field	Type	Description
`items`	array of object	List of connections for the current page.
`items[].connectionId`	string	Unique identifier for the connection.
`items[].name`	string
`items[].description`	string
`items[].gcpConfig`	object	GCP connection configuration. Server-owned fields (status, deploymentCommand) are excluded.
`items[].gcpConfig.status`	string	Server-managed GCP config status.
`items[].gcpConfig.deploymentCommand`	string	Generated deployment command.
`items[].gcpConfig.organizationId`	string
`items[].gcpConfig.folderId`	string
`items[].gcpConfig.projectId`	string
`items[].gcpConfig.level`	string	One of: `"organization"`, `"folder"`, `"project"`.
`items[].gcpConfig.serviceAccountName`	string
`items[].gcpConfig.predefinedRoles`	array of string
`items[].gcpConfig.customRole`	object
`items[].gcpConfig.customRole.roleId`	string
`items[].gcpConfig.customRole.permissions`	array of string
`items[].gcpConfig.infraManagerProject`	string
`items[].gcpConfig.infraManagerLocation`	string
`items[].gcpConfig.infraManagerServiceAccount`	string
`items[].awsConfig`	object	AWS connection configuration. Server-owned fields (context[].status, context[].nextStackOperation, stackSet) are excluded.
`items[].awsConfig.context`	array of object
`items[].awsConfig.context[].accountId`	string
`items[].awsConfig.context[].regions`	array of string
`items[].awsConfig.roleName`	string
`items[].awsConfig.permissions`	object
`items[].awsConfig.managementAccount`	string
`items[].awsConfig.organizationRootId`	string
`items[].awsConfig.scopeTargetedOrganizationalUnitIds`	array of string
`items[].awsConfig.scopeExplicitAccountIds`	array of string
`items[].awsConfig.scopeExcludedAccountIds`	array of string
`items[].awsConfig.scopeManagementAccountExplicitInScope`	boolean
`items[].collaborators`	array of object
`items[].collaborators[].email`	string (email)
`items[].collaborators[].role`	string	One of: `"owner"`, `"editor"`, `"user"`.
`items[].enabled`	boolean	false when the connection is disabled.
`items[].status`	string	Overall connection status.
`items[].createdAt`	string (date-time)
`items[].updatedAt`	string (date-time)
`pageToken`	string	Opaque cursor for the next page. `null` when there are no more results.
`rowCount`	integer	Always `null`. Row count is not computed for this endpoint.

Raw JSON schema

{
  "type": "object",
  "description": "Cursor-paginated list of CloudFlow connections.",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "description": "List of connections for the current page.",
      "items": {
        "type": "object",
        "description": "A cloud provider connection used in CloudFlow workflows.",
        "properties": {
          "connectionId": {
            "type": "string",
            "description": "Unique identifier for the connection."
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "gcpConfig": {
            "allOf": [
              {
                "type": "object",
                "description": "GCP connection configuration. Server-owned fields (status, deploymentCommand) are excluded.",
                "properties": {
                  "organizationId": {
                    "type": "string"
                  },
                  "folderId": {
                    "type": "string"
                  },
                  "projectId": {
                    "type": "string"
                  },
                  "level": {
                    "type": "string",
                    "enum": [
                      "organization",
                      "folder",
                      "project"
                    ]
                  },
                  "serviceAccountName": {
                    "type": "string"
                  },
                  "predefinedRoles": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "customRole": {
                    "type": "object",
                    "properties": {
                      "roleId": {
                        "type": "string"
                      },
                      "permissions": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "infraManagerProject": {
                    "type": "string"
                  },
                  "infraManagerLocation": {
                    "type": "string"
                  },
                  "infraManagerServiceAccount": {
                    "type": "string"
                  }
                }
              },
              {
                "type": "object",
                "description": "Response extends request schema with server-owned read-only fields.",
                "properties": {
                  "status": {
                    "type": "string",
                    "description": "Server-managed GCP config status."
                  },
                  "deploymentCommand": {
                    "type": "string",
                    "description": "Generated deployment command."
                  }
                }
              }
            ]
          },
          "awsConfig": {
            "allOf": [
              {
                "type": "object",
                "description": "AWS connection configuration. Server-owned fields (context[].status, context[].nextStackOperation, stackSet) are excluded.",
                "properties": {
                  "context": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "accountId": {
                          "type": "string"
                        },
                        "regions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "roleName": {
                    "type": "string"
                  },
                  "permissions": {
                    "type": "object"
                  },
                  "managementAccount": {
                    "type": "string"
                  },
                  "organizationRootId": {
                    "type": "string"
                  },
                  "scopeTargetedOrganizationalUnitIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "scopeExplicitAccountIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "scopeExcludedAccountIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "scopeManagementAccountExplicitInScope": {
                    "type": "boolean"
                  }
                }
              },
              {
                "type": "object",
                "description": "Response extends request schema with server-owned read-only fields.",
                "properties": {
                  "context": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "accountId": {
                          "type": "string"
                        },
                        "regions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "status": {
                          "type": "string",
                          "description": "Server-managed per-account deployment status."
                        }
                      }
                    }
                  }
                }
              }
            ]
          },
          "collaborators": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "role": {
                  "type": "string",
                  "enum": [
                    "owner",
                    "editor",
                    "user"
                  ]
                }
              }
            }
          },
          "enabled": {
            "type": "boolean",
            "description": "false when the connection is disabled."
          },
          "status": {
            "type": "string",
            "description": "Overall connection status."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "pageToken": {
      "type": "string",
      "nullable": true,
      "description": "Opaque cursor for the next page. `null` when there are no more results."
    },
    "rowCount": {
      "type": "integer",
      "nullable": true,
      "description": "Always `null`. Row count is not computed for this endpoint."
    }
  }
}

Errors

On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.

HTTP status	Exit code	Error code	Meaning
400	30	`VALIDATION_ERROR`	The arguments or request body were rejected. Review the command's flags and payload.
401	10	`AUTHENTICATION_FAILED`	Not signed in, or the API token is invalid. Run `dci login` or check `DCI_API_KEY`.
403	11	`PERMISSION_DENIED`	The DoiT user or the active customer context does not have access.
500	40	`API_SERVER_ERROR`	The API failed to process the request. Retryable; contact DoiT support if it persists.

Aliases: listcloudflowconnections

Flags​

Output​

Errors​

Flags

Output

Errors