Environments

List Environments

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

organizational_unitsintegerRequired

accountsintegerRequired

tagsintegerRequired

404

Not found

422

Validation Error

application/json

get

/api/environments/

HTTPcURLJavaScriptPython

GET /api/environments/?source=aws HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "Corporate",
    "source": "aws",
    "organizational_units": 1,
    "accounts": 1,
    "tags": 1
  }
]

List Linked Accounts

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

namestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

account_idstringRequired

account_namestringRequired

date_addedany ofOptional

string · date-timeOptional

or

nullOptional

system_managedany ofOptionalDefault: false

booleanOptional

or

nullOptional

tag_managedany ofOptionalDefault: false

booleanOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

get

/api/environments/linked_accounts

HTTPcURLJavaScriptPython

GET /api/environments/linked_accounts?source=aws&name=Corporate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "Corporate",
    "source": "aws",
    "account_id": "text",
    "account_name": "text",
    "date_added": "2026-03-18T20:53:11.412Z",
    "system_managed": false,
    "tag_managed": false
  }
]

List Available Accounts

get

Returns all available accounts. Note that accounts which are already associated with the supplied environment as well as those which are automated via OU associations are excluded.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

namestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

account_idstringRequired

account_namestringRequired

date_addedany ofOptional

string · date-timeOptional

or

nullOptional

system_managedany ofOptionalDefault: false

booleanOptional

or

nullOptional

tag_managedany ofOptionalDefault: false

booleanOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

get

/api/environments/accounts

HTTPcURLJavaScriptPython

GET /api/environments/accounts?source=aws&name=Corporate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "Corporate",
    "source": "aws",
    "account_id": "text",
    "account_name": "text",
    "date_added": "2026-03-18T20:53:11.412Z",
    "system_managed": false,
    "tag_managed": false
  }
]

Update Environment For Accounts

post

Update the environment associated with a list of accounts. Note that any account in the list that is already associated with an environment that is managed by the system via OU mapping will be ignored.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

account_liststring[]Required

Responses

200

Successful Response

application/json

okbooleanRequired

messageany ofOptional

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

post

/api/environments/accounts

HTTPcURLJavaScriptPython

POST /api/environments/accounts HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": "Corporate",
  "source": "aws",
  "account_list": [
    "text"
  ]
}

{
  "ok": true,
  "message": "text"
}

List Linked Organizational Units

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

namestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

organizational_unit_idstringRequired

organizational_unit_namestringRequired

date_addedany ofOptional

string · date-timeOptional

or

nullOptional

accountsany ofOptionalDefault: 0

integerOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

get

/api/environments/linked_organizational_units

HTTPcURLJavaScriptPython

GET /api/environments/linked_organizational_units?source=aws&name=Corporate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "Corporate",
    "source": "aws",
    "organizational_unit_id": "text",
    "organizational_unit_name": "text",
    "date_added": "2026-03-18T20:53:11.412Z",
    "accounts": 0
  }
]

List Organizational Units

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

namestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

organizational_unit_idstringRequired

organizational_unit_namestringRequired

404

Not found

422

Validation Error

application/json

get

/api/environments/organizational_units

HTTPcURLJavaScriptPython

GET /api/environments/organizational_units?source=aws&name=Corporate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "organizational_unit_id": "text",
    "organizational_unit_name": "text"
  }
]

Update Environment For Ous

post

Update the environment associated with a list of OUs.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

organizational_unit_liststring[]Required

Responses

200

Successful Response

application/json

okbooleanRequired

messageany ofOptional

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

post

/api/environments/organizational_units

HTTPcURLJavaScriptPython

POST /api/environments/organizational_units HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "name": "Corporate",
  "source": "aws",
  "organizational_unit_list": [
    "text"
  ]
}

{
  "ok": true,
  "message": "text"
}

Unassign Ou

delete

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ou_idstringRequired

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

okbooleanRequired

messageany ofOptional

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

delete

/api/environments/organizational_unit/unassign

HTTPcURLJavaScriptPython

DELETE /api/environments/organizational_unit/unassign?ou_id=text&name=Corporate&source=aws HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "message": "text"
}

List Tags For Environment

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

sourcestring · enumRequiredPossible values:

namestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

tag_keystringRequired

tag_valuestringRequired

case_sensitivebooleanRequired

allow_resource_overridebooleanRequired

404

Not found

422

Validation Error

application/json

get

/api/environments/tags

HTTPcURLJavaScriptPython

GET /api/environments/tags?source=aws&name=Corporate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "name": "Corporate",
    "source": "aws",
    "tag_key": "text",
    "tag_value": "text",
    "case_sensitive": true,
    "allow_resource_override": true
  }
]

Assign Tag To Environment

post

Associate a tag key/value pair with an environment

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · enumRequiredPossible values:

sourcestring · enumRequiredPossible values:

tag_keystringRequired

tag_valuestringRequired

case_sensitivebooleanRequired

allow_resource_overridebooleanRequired

Responses

200

Successful Response

application/json

okbooleanRequired

messageany ofOptional

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

post

/api/environments/tag

HTTPcURLJavaScriptPython

POST /api/environments/tag HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "name": "Corporate",
  "source": "aws",
  "tag_key": "text",
  "tag_value": "text",
  "case_sensitive": true,
  "allow_resource_override": true
}

{
  "ok": true,
  "message": "text"
}

Unassign Tag

delete

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

tag_keystringRequired

tag_valuestringRequired

sourcestring · enumRequiredPossible values:

Responses

200

Successful Response

application/json

okbooleanRequired

messageany ofOptional

stringOptional

or

nullOptional

404

Not found

422

Validation Error

application/json

delete

/api/environments/tag/unassign

HTTPcURLJavaScriptPython

DELETE /api/environments/tag/unassign?tag_key=text&tag_value=text&source=aws HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "message": "text"
}

List Active Task Status

get

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

task_typeany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

task_typestringRequired

task_idstringRequired

exectuorstringRequired

statusstringRequired

progressstringRequired

execution_idstringRequired

start_timestring · date-timeRequired

404

Not found

422

Validation Error

application/json

get

/api/environments/task_statuses/active

HTTPcURLJavaScriptPython

GET /api/environments/task_statuses/active HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "task_type": "text",
    "task_id": "text",
    "exectuor": "text",
    "status": "text",
    "progress": "text",
    "execution_id": "text",
    "start_time": "2026-03-18T20:53:11.412Z"
  }
]