> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/api-reference/software-delivery-agent-apis/infrastructure-as-code-management/execution-environments.md).

# Execution Environments

Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported.

## Create an Execution Environment on account level

> Create an Execution Environment on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment":{"post":{"tags":["execution_environments"],"summary":"Create an Execution Environment on account level","description":"Create an Execution Environment on account level.","operationId":"execution_environments#create-execution-environment-account-level","parameters":[{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"201":{"description":"Created response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"CreateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"identifier":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"image_tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags stages may run on. Must include default_tag.","minItems":1},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},"required":["identifier","name","connector_ref","image","default_tag","type","image_tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Get an Execution Environment on account level

> Get an Execution Environment and its image tags on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{identifier}":{"get":{"tags":["execution_environments"],"summary":"Get an Execution Environment on account level","description":"Get an Execution Environment and its image tags on account level.","operationId":"execution_environments#get-execution-environment-account-level","parameters":[{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Update an Execution Environment on account level

> Update an Execution Environment on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{identifier}":{"put":{"tags":["execution_environments"],"summary":"Update an Execution Environment on account level","description":"Update an Execution Environment on account level.","operationId":"execution_environments#update-execution-environment-account-level","parameters":[{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"UpdateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}}},"required":["name","connector_ref","image","default_tag"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment on account level

> Delete an Execution Environment on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{identifier}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment on account level","description":"Delete an Execution Environment on account level.","operationId":"execution_environments#delete-execution-environment-account-level","parameters":[{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Add Execution Environment image tags on account level

> Add image tags to an Execution Environment on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{identifier}/tags":{"post":{"tags":["execution_environments"],"summary":"Add Execution Environment image tags on account level","description":"Add image tags to an Execution Environment on account level.","operationId":"execution_environments#add-execution-environment-tags-account-level","parameters":[{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddExecutionEnvironmentTagsAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AddExecutionEnvironmentTagsAccountLevelRequestBody":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags to add. None may already exist.","minItems":1}},"required":["tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment image tag on account level

> Delete an image tag from an Execution Environment on account level. The default tag cannot be deleted.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{identifier}/tags/{tag}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment image tag on account level","description":"Delete an image tag from an Execution Environment on account level. The default tag cannot be deleted.","operationId":"execution_environments#delete-execution-environment-tag-account-level","parameters":[{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"tag","in":"path","description":"Image tag.","required":true,"schema":{"type":"string","description":"Image tag.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Report the plugin version of an Execution Environment image tag

> Record the IaCM plugin version found in an Execution Environment image tag. Called by the plugin at run time with a service token.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environment/{unique_id}/tags/{tag}/plugin-version":{"post":{"tags":["execution_environments"],"summary":"Report the plugin version of an Execution Environment image tag","description":"Record the IaCM plugin version found in an Execution Environment image tag. Called by the plugin at run time with a service token.","operationId":"execution_environments#report-execution-environment-plugin-version","parameters":[{"name":"unique_id","in":"path","description":"Unique ID of the Execution Environment, as passed to the plugin.","required":true,"schema":{"type":"string","description":"Unique ID of the Execution Environment, as passed to the plugin.","minLength":1,"maxLength":36}},{"name":"tag","in":"path","description":"Image tag.","required":true,"schema":{"type":"string","description":"Image tag.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"commit":{"type":"string","description":"Plugin commit.","maxLength":64},"version":{"type":"string","description":"Plugin version.","minLength":1,"maxLength":64}}}}}},"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## List Execution Environments on account level

> List the Execution Environments the caller can view on account level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/execution-environments":{"get":{"tags":["execution_environments"],"summary":"List Execution Environments on account level","description":"List the Execution Environments the caller can view on account level.","operationId":"execution_environments#list-execution-environments-account-level","parameters":[{"name":"type","in":"query","description":"Only return environments of this type.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments of this type.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},{"name":"search_term","in":"query","description":"Only return environments whose name or identifier contains this text, ignoring case.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments whose name or identifier contains this text, ignoring case.","maxLength":128}},{"name":"limit","in":"query","description":"Limit is the number of records to return for a page.","allowEmptyValue":true,"schema":{"type":"integer","description":"Limit is the number of records to return for a page.","default":30,"format":"int64","minimum":1,"maximum":1000}},{"name":"page","in":"query","description":"Page is the page number to return relative to the page 'limit'.","allowEmptyValue":true,"schema":{"type":"integer","description":"Page is the page number to return relative to the page 'limit'.","default":1,"format":"int64","minimum":1}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","headers":{},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"},"description":"The Execution Environments on this page."}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Create an Execution Environment on org level

> Create an Execution Environment on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment":{"post":{"tags":["execution_environments"],"summary":"Create an Execution Environment on org level","description":"Create an Execution Environment on org level.","operationId":"execution_environments#create-execution-environment-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"201":{"description":"Created response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"CreateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"identifier":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"image_tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags stages may run on. Must include default_tag.","minItems":1},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},"required":["identifier","name","connector_ref","image","default_tag","type","image_tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Get an Execution Environment on org level

> Get an Execution Environment and its image tags on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment/{identifier}":{"get":{"tags":["execution_environments"],"summary":"Get an Execution Environment on org level","description":"Get an Execution Environment and its image tags on org level.","operationId":"execution_environments#get-execution-environment-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Update an Execution Environment on org level

> Update an Execution Environment on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment/{identifier}":{"put":{"tags":["execution_environments"],"summary":"Update an Execution Environment on org level","description":"Update an Execution Environment on org level.","operationId":"execution_environments#update-execution-environment-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"UpdateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}}},"required":["name","connector_ref","image","default_tag"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment on org level

> Delete an Execution Environment on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment/{identifier}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment on org level","description":"Delete an Execution Environment on org level.","operationId":"execution_environments#delete-execution-environment-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Add Execution Environment image tags on org level

> Add image tags to an Execution Environment on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment/{identifier}/tags":{"post":{"tags":["execution_environments"],"summary":"Add Execution Environment image tags on org level","description":"Add image tags to an Execution Environment on org level.","operationId":"execution_environments#add-execution-environment-tags-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddExecutionEnvironmentTagsAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AddExecutionEnvironmentTagsAccountLevelRequestBody":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags to add. None may already exist.","minItems":1}},"required":["tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment image tag on org level

> Delete an image tag from an Execution Environment on org level. The default tag cannot be deleted.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environment/{identifier}/tags/{tag}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment image tag on org level","description":"Delete an image tag from an Execution Environment on org level. The default tag cannot be deleted.","operationId":"execution_environments#delete-execution-environment-tag-org-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"tag","in":"path","description":"Image tag.","required":true,"schema":{"type":"string","description":"Image tag.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## List Execution Environments on org level

> List the Execution Environments the caller can view on org level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/execution-environments":{"get":{"tags":["execution_environments"],"summary":"List Execution Environments on org level","description":"List the Execution Environments the caller can view on org level.","operationId":"execution_environments#list-execution-environments-org-level","parameters":[{"name":"type","in":"query","description":"Only return environments of this type.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments of this type.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},{"name":"search_term","in":"query","description":"Only return environments whose name or identifier contains this text, ignoring case.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments whose name or identifier contains this text, ignoring case.","maxLength":128}},{"name":"include_parent_scopes","in":"query","description":"Also return environments from the parent org and account, as the stage picker offers them.","allowEmptyValue":true,"schema":{"type":"boolean","description":"Also return environments from the parent org and account, as the stage picker offers them.","default":false}},{"name":"limit","in":"query","description":"Limit is the number of records to return for a page.","allowEmptyValue":true,"schema":{"type":"integer","description":"Limit is the number of records to return for a page.","default":30,"format":"int64","minimum":1,"maximum":1000}},{"name":"page","in":"query","description":"Page is the page number to return relative to the page 'limit'.","allowEmptyValue":true,"schema":{"type":"integer","description":"Page is the page number to return relative to the page 'limit'.","default":1,"format":"int64","minimum":1}},{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","headers":{},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"},"description":"The Execution Environments on this page."}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Create an Execution Environment on project level

> Create an Execution Environment on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment":{"post":{"tags":["execution_environments"],"summary":"Create an Execution Environment on project level","description":"Create an Execution Environment on project level.","operationId":"execution_environments#create-execution-environment-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"201":{"description":"Created response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"CreateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"identifier":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"image_tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags stages may run on. Must include default_tag.","minItems":1},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},"required":["identifier","name","connector_ref","image","default_tag","type","image_tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Get an Execution Environment on project level

> Get an Execution Environment and its image tags on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment/{identifier}":{"get":{"tags":["execution_environments"],"summary":"Get an Execution Environment on project level","description":"Get an Execution Environment and its image tags on project level.","operationId":"execution_environments#get-execution-environment-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Update an Execution Environment on project level

> Update an Execution Environment on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment/{identifier}":{"put":{"tags":["execution_environments"],"summary":"Update an Execution Environment on project level","description":"Update an Execution Environment on project level.","operationId":"execution_environments#update-execution-environment-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateExecutionEnvironmentAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"UpdateExecutionEnvironmentAccountLevelRequestBody":{"type":"object","properties":{"connector_ref":{"type":"string","description":"Container registry connector used to pull the image. Account level environments need an account. connector, org level ones an account. or org. connector.","minLength":1,"maxLength":255},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one. Must be one of the image tags.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":{"type":"string","description":"Description provides long-form text about the resource.","maxLength":1024},"image":{"type":"string","description":"Image name without a tag or digest.","minLength":1,"maxLength":1024},"name":{"type":"string","description":"Name is the human readable name for the resource.","minLength":1,"maxLength":128},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}}},"required":["name","connector_ref","image","default_tag"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment on project level

> Delete an Execution Environment on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment/{identifier}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment on project level","description":"Delete an Execution Environment on project level.","operationId":"execution_environments#delete-execution-environment-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Add Execution Environment image tags on project level

> Add image tags to an Execution Environment on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment/{identifier}/tags":{"post":{"tags":["execution_environments"],"summary":"Add Execution Environment image tags on project level","description":"Add image tags to an Execution Environment on project level.","operationId":"execution_environments#add-execution-environment-tags-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddExecutionEnvironmentTagsAccountLevelRequestBody"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AddExecutionEnvironmentTagsAccountLevelRequestBody":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128},"description":"Image tags to add. None may already exist.","minItems":1}},"required":["tags"]},"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Delete an Execution Environment image tag on project level

> Delete an image tag from an Execution Environment on project level. The default tag cannot be deleted.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environment/{identifier}/tags/{tag}":{"delete":{"tags":["execution_environments"],"summary":"Delete an Execution Environment image tag on project level","description":"Delete an image tag from an Execution Environment on project level. The default tag cannot be deleted.","operationId":"execution_environments#delete-execution-environment-tag-proj-level","parameters":[{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"identifier","in":"path","description":"Identifier is the Execution Environment identifier.","required":true,"schema":{"type":"string","description":"Identifier is the Execution Environment identifier.","pattern":"^[a-zA-Z_][0-9a-zA-Z_]*$","minLength":1,"maxLength":128}},{"name":"tag","in":"path","description":"Image tag.","required":true,"schema":{"type":"string","description":"Image tag.","pattern":"^[A-Za-z0-9_][A-Za-z0-9_.-]*$","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"204":{"description":"No Content response."},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## List Execution Environments on project level

> List the Execution Environments the caller can view on project level.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environments":{"get":{"tags":["execution_environments"],"summary":"List Execution Environments on project level","description":"List the Execution Environments the caller can view on project level.","operationId":"execution_environments#list-execution-environments-proj-level","parameters":[{"name":"type","in":"query","description":"Only return environments of this type.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments of this type.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]}},{"name":"search_term","in":"query","description":"Only return environments whose name or identifier contains this text, ignoring case.","allowEmptyValue":true,"schema":{"type":"string","description":"Only return environments whose name or identifier contains this text, ignoring case.","maxLength":128}},{"name":"include_parent_scopes","in":"query","description":"Also return environments from the parent org and account, as the stage picker offers them.","allowEmptyValue":true,"schema":{"type":"boolean","description":"Also return environments from the parent org and account, as the stage picker offers them.","default":false}},{"name":"limit","in":"query","description":"Limit is the number of records to return for a page.","allowEmptyValue":true,"schema":{"type":"integer","description":"Limit is the number of records to return for a page.","default":30,"format":"int64","minimum":1,"maximum":1000}},{"name":"page","in":"query","description":"Page is the page number to return relative to the page 'limit'.","allowEmptyValue":true,"schema":{"type":"integer","description":"Page is the page number to return relative to the page 'limit'.","default":1,"format":"int64","minimum":1}},{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","headers":{},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentResource"},"description":"The Execution Environments on this page."}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResource":{"type":"object","properties":{"account":{"type":"string","description":"Account is the internal customer account ID."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"created":{"type":"integer","description":"Timestamp when the Execution Environment was created.","format":"int64"},"default_tag":{"type":"string","description":"Image tag a stage runs on when it does not pick one."},"description":{"type":"string","description":"Description provides long-form text about the resource."},"identifier":{"type":"string","description":"Identifier of the Execution Environment, unique within its scope."},"image":{"type":"string","description":"Image name without a tag."},"image_tags":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionEnvironmentImageTag"},"description":"Image tags stages may run on."},"name":{"type":"string","description":"Name is the human readable name for the resource."},"org":{"type":"string","description":"Org is the organisation identifier, empty at account level."},"project":{"type":"string","description":"Project is the project identifier, empty at account and org level."},"tags":{"type":"object","description":"Harness tags on the resource.","additionalProperties":{"type":"string"}},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"updated":{"type":"integer","description":"Timestamp when the Execution Environment was last updated.","format":"int64"}},"description":"An Execution Environment: a container registry connector and custom IaCM plugin image, with the image tags stages may run on.","required":["identifier","account","org","project","type","name","tags","connector_ref","image","default_tag","image_tags","created","updated"]},"ExecutionEnvironmentImageTag":{"type":"object","properties":{"created":{"type":"integer","description":"Timestamp when the tag was added.","format":"int64"},"plugin_commit":{"type":"string","description":"IaCM plugin commit last reported for this tag."},"plugin_version":{"type":"string","description":"IaCM plugin version last reported for this tag. Absent until a stage has run on it."},"plugin_version_reported":{"type":"integer","description":"Timestamp when the plugin version was last reported.","format":"int64"},"tag":{"type":"string","description":"Image tag."}},"description":"An image tag of an Execution Environment.","required":["tag","created"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```

## Resolve an Execution Environment

> Resolve an Execution Environment reference for a stage in the given project. Service tokens only.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"execution_environments","description":"Execution Environments Service manages custom IaCM plugin images: a container registry connector, an image and the image tags a stage may run on, with the plugin version each tag last reported."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/execution-environments/resolve":{"get":{"tags":["execution_environments"],"summary":"Resolve an Execution Environment","description":"Resolve an Execution Environment reference for a stage in the given project. Service tokens only.","operationId":"execution_environments#resolve-execution-environment","parameters":[{"name":"ref","in":"query","description":"Environment reference as written in the stage: account.<id>, org.<id> or <id>.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Environment reference as written in the stage: account.<id>, org.<id> or <id>.","minLength":1,"maxLength":256}},{"name":"tag","in":"query","description":"Image tag to run on. Empty means the environment's current default tag.","allowEmptyValue":true,"schema":{"type":"string","description":"Image tag to run on. Empty means the environment's current default tag.","maxLength":128}},{"name":"org","in":"path","description":"Org is the organisation identifier.","required":true,"schema":{"type":"string","description":"Org is the organisation identifier.","minLength":1,"maxLength":128}},{"name":"project","in":"path","description":"Project is the project identifier.","required":true,"schema":{"type":"string","description":"Project is the project identifier.","minLength":1,"maxLength":128}},{"name":"Harness-Account","in":"header","description":"Account is the internal customer account ID.","allowEmptyValue":true,"required":true,"schema":{"type":"string","description":"Account is the internal customer account ID.","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionEnvironmentResolution"}}}},"400":{"description":"BadRequestError: Bad Request response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UnauthorizedError: Unauthorized response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"ForbiddenError: Forbidden response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NotFoundError: Not Found response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"408":{"description":"TimeoutError: Request Timeout response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"ConflictError: Conflict response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"423":{"description":"LockedError: Locked response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"499":{"description":"ContextCancelledError:  response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"InternalServerError: Internal Server Error response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"BadGatewayError: Bad Gateway response.","content":{"application/vnd.goa.error":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ExecutionEnvironmentResolution":{"type":"object","properties":{"account":{"type":"string","description":"Account the Execution Environment belongs to."},"connector_ref":{"type":"string","description":"Container registry connector used to pull the image."},"identifier":{"type":"string","description":"Identifier of the Execution Environment."},"image":{"type":"string","description":"Image name without a tag."},"org":{"type":"string","description":"Org the Execution Environment belongs to, empty at account level."},"project":{"type":"string","description":"Project the Execution Environment belongs to, empty at account and org level."},"tag":{"type":"string","description":"Image tag to run on."},"type":{"type":"string","description":"Provisioner the Execution Environment is used with. Fixed at creation.","enum":["ansible","terraform","opentofu","terragrunt","awscdk"]},"unique_id":{"type":"string","description":"Unique ID of the Execution Environment, passed to the plugin so it can report its version."}},"description":"The image a stage runs on, resolved from an Execution Environment reference.","required":["unique_id","identifier","account","org","project","type","connector_ref","image","tag"]},"Error":{"type":"object","properties":{"fault":{"type":"boolean","description":"Is the error a server-side fault?"},"id":{"type":"string","description":"ID is a unique identifier for this particular occurrence of the problem."},"message":{"type":"string","description":"Message is a human-readable explanation specific to this occurrence of the problem."},"name":{"type":"string","description":"Name is the name of this class of errors."},"temporary":{"type":"boolean","description":"Is the error temporary?"},"timeout":{"type":"boolean","description":"Is the error a timeout?"}},"required":["name","id","message","temporary","timeout","fault"]}}}}
```
