Brainboard API (1.0)

Download OpenAPI specification:Download

Brainboard API documentation

Architecture Template

ListArchitectureTemplates

List all available architecture templates.

Authorizations:
ApiKeyAuth

Responses

Response Schema: application/json
Array
approved
boolean
object (model.User)
clone_count
integer
cloud_provider
string
Enum: "aws" "azurerm" "google" "scaleway" "oci" "azuread" "azuredevops" "azurestack" "kubernetes" ""

Filled during the clone process

object (JSON)
created_at
string
created_by
string <uuid>
current_version_id
string <uuid>
description
string
environment
string <uuid>
import_verified
boolean
imported
boolean
name
string
object (Nodes)
object (JSON)
project
string <uuid>
readme
string
snapshot_url
string
status
string
synced
boolean
object (JSON)
tags
Array of strings
template
boolean
terraform_binary
string
terraform_provider
string
terraform_version
string
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
object (FlattenJSON)
visibility
string (brainboard_co_brainboard_pkg_domain_security_visibility.Visibility)
Enum: "public" "organization"

Response samples

Content type
application/json
[
  • {
    • "approved": true,
    • "author": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "clone_count": 0,
    • "cloud_provider": "aws",
    • "cloud_providers_version": { },
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",
    • "description": "string",
    • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
    • "import_verified": true,
    • "imported": true,
    • "name": "string",
    • "nodes": {
      • "property1": {
        },
      • "property2": {
        }
      },
    • "outputs": { },
    • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
    • "readme": "string",
    • "snapshot_url": "string",
    • "status": "string",
    • "synced": true,
    • "synced_architectures": { },
    • "tags": [
      • "string"
      ],
    • "template": true,
    • "terraform_binary": "string",
    • "terraform_provider": "string",
    • "terraform_version": "string",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    • "variable_settings": {
      • "property1": "string",
      • "property2": "string"
      },
    • "visibility": "public"
    }
]

CreateArchitectureTemplate

Creates a new architecture template.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

CloneArchitecture Request

architecture
required
string <uuid>

source architecture or template ID

description
string

new architecture description

name
required
string

new architecture name

visibility
required
string
Enum: "public" "organization"

architecture template visibility

Responses

Response Schema: application/json
approved
boolean
object (model.User)
clone_count
integer
cloud_provider
string
Enum: "aws" "azurerm" "google" "scaleway" "oci" "azuread" "azuredevops" "azurestack" "kubernetes" ""

Filled during the clone process

object (JSON)
created_at
string
created_by
string <uuid>
current_version_id
string <uuid>
description
string
environment
string <uuid>
import_verified
boolean
imported
boolean
name
string
object (Nodes)
object (JSON)
project
string <uuid>
readme
string
snapshot_url
string
status
string
synced
boolean
object (JSON)
tags
Array of strings
template
boolean
terraform_binary
string
terraform_provider
string
terraform_version
string
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
object (FlattenJSON)
visibility
string (brainboard_co_brainboard_pkg_domain_security_visibility.Visibility)
Enum: "public" "organization"

Request samples

Content type
application/json
{
  • "architecture": "7638ff16-0349-4686-bf45-5444f117cc0c",
  • "description": "string",
  • "name": "string",
  • "visibility": "public"
}

Response samples

Content type
application/json
{
  • "approved": true,
  • "author": {
    • "accept_news": true,
    • "avatar_url": "string",
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "disabled": true,
    • "email": "string",
    • "email_confirmed": true,
    • "firstname": "string",
    • "lastname": "string",
    • "organization_role": "string",
    • "role": "string",
    • "terraform_modules_pinned": [
      • "string"
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    },
  • "clone_count": 0,
  • "cloud_provider": "aws",
  • "cloud_providers_version": { },
  • "created_at": "string",
  • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  • "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",
  • "description": "string",
  • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
  • "import_verified": true,
  • "imported": true,
  • "name": "string",
  • "nodes": {
    • "property1": {
      • "cloudConfig": { },
      • "graphics": {
        },
      • "metadata": {
        }
      },
    • "property2": {
      • "cloudConfig": { },
      • "graphics": {
        },
      • "metadata": {
        }
      }
    },
  • "outputs": { },
  • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
  • "readme": "string",
  • "snapshot_url": "string",
  • "status": "string",
  • "synced": true,
  • "synced_architectures": { },
  • "tags": [
    • "string"
    ],
  • "template": true,
  • "terraform_binary": "string",
  • "terraform_provider": "string",
  • "terraform_version": "string",
  • "updated_at": "string",
  • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "variable_settings": {
    • "property1": "string",
    • "property2": "string"
    },
  • "visibility": "public"
}

CloneFromTemplate

This endpoint clones an architecture from a template.

Authorizations:
ApiKeyAuth
path Parameters
architectureUUID
required
string

Architecture Template UUID

Request Body schema: application/json
required

CloneArchitecture Request

description
string

new architecture description

environment
required
string <uuid>

parent environment ID

name
required
string

new architecture name

project
required
string <uuid>

parent project ID

object

list of variables to override the cloned architecture variables

workflow_template
string <uuid>

workflow template ID

Responses

Response Schema: application/json
object

The new architecture

object

The new workflow if workflow_template was defined in the request, null otherwise

Request samples

Content type
application/json
{
  • "description": "string",
  • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
  • "name": "string",
  • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
  • "variable_values": {
    • "property1": "string",
    • "property2": "string"
    },
  • "workflow_template": "098a1f63-b575-4217-9b55-44bb5bf1744b"
}

Response samples

Content type
application/json
{
  • "architecture": {
    • "approved": true,
    • "author": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "clone_count": 0,
    • "cloud_provider": "aws",
    • "cloud_providers_version": { },
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",
    • "description": "string",
    • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
    • "import_verified": true,
    • "imported": true,
    • "name": "string",
    • "nodes": {
      • "property1": {
        },
      • "property2": {
        }
      },
    • "outputs": { },
    • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
    • "readme": "string",
    • "snapshot_url": "string",
    • "status": "string",
    • "synced": true,
    • "synced_architectures": { },
    • "tags": [
      • "string"
      ],
    • "template": true,
    • "terraform_binary": "string",
    • "terraform_provider": "string",
    • "terraform_version": "string",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    • "variable_settings": {
      • "property1": "string",
      • "property2": "string"
      },
    • "visibility": "public"
    },
  • "workflow": {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "description": "string",
    • "editor": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "notification_recipients": [
      • "string"
      ],
    • "notify_on_failure": true,
    • "snapshot_link": "string",
    • "tasks": [
      • {
        }
      ],
    • "title": "string",
    • "triggers": {
      • "property1": "string",
      • "property2": "string"
      },
    • "type": "workflow",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
}

Architecture

CloneArchitecture

Creates a new architecture cloned from a source architecture.

Authorizations:
ApiKeyAuth
path Parameters
architectureUUID
required
string

Architecture ID

Request Body schema: application/json
required

CloneArchitecture Request

description
string

new architecture description

environment
required
string <uuid>

parent environment ID

name
required
string

new architecture name

project
required
string <uuid>

parent project ID

synced
boolean

Set to true to sync the cloned architecture with the source architecture

object

list of variables to override the cloned architecture variables

workflow_template
string <uuid>

workflow template ID

Responses

Response Schema: application/json
approved
boolean
object (model.User)
clone_count
integer
cloud_provider
string
Enum: "aws" "azurerm" "google" "scaleway" "oci" "azuread" "azuredevops" "azurestack" "kubernetes" ""

Filled during the clone process

object (JSON)
created_at
string
created_by
string <uuid>
current_version_id
string <uuid>
description
string
environment
string <uuid>
import_verified
boolean
imported
boolean
name
string
object (Nodes)
object (JSON)
project
string <uuid>
readme
string
snapshot_url
string
status
string
synced
boolean
object (JSON)
tags
Array of strings
template
boolean
terraform_binary
string
terraform_provider
string
terraform_version
string
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
object (FlattenJSON)
visibility
string (brainboard_co_brainboard_pkg_domain_security_visibility.Visibility)
Enum: "public" "organization"

Request samples

Content type
application/json
{
  • "description": "string",
  • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
  • "name": "string",
  • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
  • "synced": true,
  • "variable_values": {
    • "property1": "string",
    • "property2": "string"
    },
  • "workflow_template": "098a1f63-b575-4217-9b55-44bb5bf1744b"
}

Response samples

Content type
application/json
{
  • "approved": true,
  • "author": {
    • "accept_news": true,
    • "avatar_url": "string",
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "disabled": true,
    • "email": "string",
    • "email_confirmed": true,
    • "firstname": "string",
    • "lastname": "string",
    • "organization_role": "string",
    • "role": "string",
    • "terraform_modules_pinned": [
      • "string"
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    },
  • "clone_count": 0,
  • "cloud_provider": "aws",
  • "cloud_providers_version": { },
  • "created_at": "string",
  • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  • "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",
  • "description": "string",
  • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
  • "import_verified": true,
  • "imported": true,
  • "name": "string",
  • "nodes": {
    • "property1": {
      • "cloudConfig": { },
      • "graphics": {
        },
      • "metadata": {
        }
      },
    • "property2": {
      • "cloudConfig": { },
      • "graphics": {
        },
      • "metadata": {
        }
      }
    },
  • "outputs": { },
  • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
  • "readme": "string",
  • "snapshot_url": "string",
  • "status": "string",
  • "synced": true,
  • "synced_architectures": { },
  • "tags": [
    • "string"
    ],
  • "template": true,
  • "terraform_binary": "string",
  • "terraform_provider": "string",
  • "terraform_version": "string",
  • "updated_at": "string",
  • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "variable_settings": {
    • "property1": "string",
    • "property2": "string"
    },
  • "visibility": "public"
}

ListArchitectures

List all architectures from a parent environment.

Authorizations:
ApiKeyAuth
path Parameters
environmentUUID
required
string

Environment ID

Responses

Response Schema: application/json
Array
approved
boolean
object (model.User)
clone_count
integer
cloud_provider
string
Enum: "aws" "azurerm" "google" "scaleway" "oci" "azuread" "azuredevops" "azurestack" "kubernetes" ""

Filled during the clone process

object (JSON)
created_at
string
created_by
string <uuid>
current_version_id
string <uuid>
description
string
environment
string <uuid>
import_verified
boolean
imported
boolean
name
string
object (Nodes)
object (JSON)
project
string <uuid>
readme
string
snapshot_url
string
status
string
synced
boolean
object (JSON)
tags
Array of strings
template
boolean
terraform_binary
string
terraform_provider
string
terraform_version
string
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
object (FlattenJSON)
visibility
string (brainboard_co_brainboard_pkg_domain_security_visibility.Visibility)
Enum: "public" "organization"

Response samples

Content type
application/json
[
  • {
    • "approved": true,
    • "author": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "clone_count": 0,
    • "cloud_provider": "aws",
    • "cloud_providers_version": { },
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",
    • "description": "string",
    • "environment": "fafd1151-c401-4fdd-ac01-03d8e7a57166",
    • "import_verified": true,
    • "imported": true,
    • "name": "string",
    • "nodes": {
      • "property1": {
        },
      • "property2": {
        }
      },
    • "outputs": { },
    • "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2",
    • "readme": "string",
    • "snapshot_url": "string",
    • "status": "string",
    • "synced": true,
    • "synced_architectures": { },
    • "tags": [
      • "string"
      ],
    • "template": true,
    • "terraform_binary": "string",
    • "terraform_provider": "string",
    • "terraform_version": "string",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    • "variable_settings": {
      • "property1": "string",
      • "property2": "string"
      },
    • "visibility": "public"
    }
]

Workflows

ListWorkflows

List all architecture workflows.

Authorizations:
ApiKeyAuth

Responses

Response Schema: application/json
Array
created_at
string
created_by
string <uuid>
description
string
object (model.User)
notification_recipients
Array of strings
notify_on_failure
boolean
snapshot_link
string
Array of objects (WorkflowTaskConfiguration)
title
string
object (FlattenJSON)
type
string (WorkflowType)
Enum: "workflow" "one_action" "state_action"
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>

Response samples

Content type
application/json
[
  • {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "description": "string",
    • "editor": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "notification_recipients": [
      • "string"
      ],
    • "notify_on_failure": true,
    • "snapshot_link": "string",
    • "tasks": [
      • {
        }
      ],
    • "title": "string",
    • "triggers": {
      • "property1": "string",
      • "property2": "string"
      },
    • "type": "workflow",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
]

TriggerManualPipeline

Triggers a pipeline for a given workflow and architecture.

Authorizations:
ApiKeyAuth
path Parameters
workflowID
required
string

Workflow ID

architectureUUID
required
string

Architecture ID

Responses

Response Schema: application/json
architecture_id
string
object (model.User)
created_at
string
created_by
string <uuid>
finish_time
string
Array of objects (model.Job)
notification_recipients
Array of strings
notify_on_failure
boolean
start_time
string
started_reason
string (runner.WorkflowTrigger)
Enum: "cron" "webhook" "manual" "one-action" "state-action"
status
string (runner.WorkflowStatus)
Enum: "scheduled" "manual" "pending" "running" "succeeded" "failed" "error" "warning" "terminated"
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
object (Workflow)

Response samples

Content type
application/json
{
  • "architecture_id": "string",
  • "author": {
    • "accept_news": true,
    • "avatar_url": "string",
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "disabled": true,
    • "email": "string",
    • "email_confirmed": true,
    • "firstname": "string",
    • "lastname": "string",
    • "organization_role": "string",
    • "role": "string",
    • "terraform_modules_pinned": [
      • "string"
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    },
  • "created_at": "string",
  • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  • "finish_time": "string",
  • "jobs": [
    • {
      • "action": "string",
      • "app_url": "string",
      • "approved_by": {
        },
      • "architecture_id": "string",
      • "arguments": {
        },
      • "cli_arguments": {
        },
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "credentials": [
        ],
      • "depends_on": [
        ],
      • "graphics": {
        },
      • "pipeline_id": "string",
      • "runner_id": "string",
      • "status": "scheduled",
      • "title": "string",
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      • "workflow_id": "string"
      }
    ],
  • "notification_recipients": [
    • "string"
    ],
  • "notify_on_failure": true,
  • "start_time": "string",
  • "started_reason": "cron",
  • "status": "scheduled",
  • "updated_at": "string",
  • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  • "workflow": {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "description": "string",
    • "editor": {
      • "accept_news": true,
      • "avatar_url": "string",
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "disabled": true,
      • "email": "string",
      • "email_confirmed": true,
      • "firstname": "string",
      • "lastname": "string",
      • "organization_role": "string",
      • "role": "string",
      • "terraform_modules_pinned": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      },
    • "notification_recipients": [
      • "string"
      ],
    • "notify_on_failure": true,
    • "snapshot_link": "string",
    • "tasks": [
      • {
        }
      ],
    • "title": "string",
    • "triggers": {
      • "property1": "string",
      • "property2": "string"
      },
    • "type": "workflow",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
}

ListWorkflowTemplates

Lists all available workflow templates.

Authorizations:
ApiKeyAuth

Responses

Response Schema: application/json
created_at
string
created_by
string <uuid>
description
string
object (model.User)
notification_recipients
Array of strings
notify_on_failure
boolean
snapshot_link
string
Array of objects (WorkflowTaskConfiguration)
title
string
object (FlattenJSON)
type
string (WorkflowType)
Enum: "workflow" "one_action" "state_action"
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>

Response samples

Content type
application/json
{
  • "created_at": "string",
  • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  • "description": "string",
  • "editor": {
    • "accept_news": true,
    • "avatar_url": "string",
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "disabled": true,
    • "email": "string",
    • "email_confirmed": true,
    • "firstname": "string",
    • "lastname": "string",
    • "organization_role": "string",
    • "role": "string",
    • "terraform_modules_pinned": [
      • "string"
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    },
  • "notification_recipients": [
    • "string"
    ],
  • "notify_on_failure": true,
  • "snapshot_link": "string",
  • "tasks": [
    • {
      • "action": "string",
      • "arguments": {
        },
      • "depends_on": [
        ],
      • "graphics": {
        },
      • "title": "string",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      }
    ],
  • "title": "string",
  • "triggers": {
    • "property1": "string",
    • "property2": "string"
    },
  • "type": "workflow",
  • "updated_at": "string",
  • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
  • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}

Project

ListProjects

Lists all organization projects.

Authorizations:
ApiKeyAuth

Responses

Response Schema: application/json
Array
created_at
string
created_by
string <uuid>
description
string
Array of objects (Environment)
name
string
role
string

Used to give the User role in this project in ListProjects()

tags
Array of strings
Array of objects (Team)
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>

Response samples

Content type
application/json
[
  • {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "description": "string",
    • "environments": [
      • {
        }
      ],
    • "name": "string",
    • "role": "string",
    • "tags": [
      • "string"
      ],
    • "teams": [
      • {
        }
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
]

CreateProject

Creates a new project.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

CreateProject body

description
string

description of the project

required
Array of objects (Environment)

new project environments

name
required
string

name of the project

required
Array of objects (Team)

list of teams allowed to access the new project

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "environments": [
    • {
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "description": "string",
      • "name": "string",
      • "tags": [
        ],
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      }
    ],
  • "name": "string",
  • "teams": [
    • {
      • "created_at": "string",
      • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
      • "force_2fa": true,
      • "name": "string",
      • "role": "string",
      • "updated_at": "string",
      • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
      • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
      }
    ]
}

Response samples

Content type
application/json
{
  • "property1": "string",
  • "property2": "string"
}

Environment

ListEnvironments

Lists all environments from a project.

Authorizations:
ApiKeyAuth
path Parameters
projectUUID
required
string

Parent project ID

Responses

Response Schema: application/json
Array
created_at
string
created_by
string <uuid>
description
string
name
string
tags
Array of strings
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>

Response samples

Content type
application/json
[
  • {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "description": "string",
    • "name": "string",
    • "tags": [
      • "string"
      ],
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
]

Variables

ImportVariables

Imports variables from terraform files into an existing architecture.

Request Body schema: multipart/form-data
required

ImportVariables body

override
boolean

set to true to override existing variables

Responses

Response samples

Content type
application/json
{
  • "content": { },
  • "error_code": "INTERNAL_ERROR"
}

ListVariables

Lists all architecture variables.

Authorizations:
ApiKeyAuth
path Parameters
architectureUUID
required
string

Architecture ID

Responses

Response Schema: application/json
Array
created_at
string
created_by
string <uuid>
default
string
description
string
name
string
scope
string (VariableScope)
Enum: "organization" "project" "environment" "architecture" "locals"
scope_id
string <uuid>
sensitive
boolean
type
string
updated_at
string
updated_by
string <uuid>
uuid
string <uuid>
validation
string
value
string

Response samples

Content type
application/json
[
  • {
    • "created_at": "string",
    • "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
    • "default": "string",
    • "description": "string",
    • "name": "string",
    • "scope": "organization",
    • "scope_id": "5d3fe357-12dd-4f62-b004-6d1fb3b8454f",
    • "sensitive": true,
    • "type": "string",
    • "updated_at": "string",
    • "updated_by": "deea00dc-b6b6-4412-a483-26ac61e1f6fe",
    • "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    • "validation": "string",
    • "value": "string"
    }
]

UpdateVariable

Update a single variable.

Authorizations:
ApiKeyAuth
path Parameters
variableUUID
required
string

variable ID

Request Body schema: application/json
required

createOrUpdateVariable Request

default
string

default variable value

description
string

variable description

name
string

variable name

scope
string (VariableScope)
Enum: "organization" "project" "environment" "architecture" "locals"
scope_id
string
sensitive
boolean

set to true to hide variable value in terraform commands output

type
string

variable type

validation
string

variable validation rules

value
string

variable value

Responses

Request samples

Content type
application/json
{
  • "default": "string",
  • "description": "string",
  • "name": "string",
  • "scope": "organization",
  • "scope_id": "string",
  • "sensitive": true,
  • "type": "string",
  • "validation": "string",
  • "value": "string"
}

Response samples

Content type
application/json
{
  • "details": {
    • "message": "string"
    },
  • "error": "string"
}