> 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/iacm/unified-executions.md).

# Unified Executions

Unified Executions Service handles the API for unified workflow executions.

## Create unified execution

> Create a new unified execution.

```json
{"openapi":"3.0.3","info":{"title":"Infrastructure as Code Management","version":"0.1.0"},"tags":[{"name":"unified-executions","description":"Unified Executions Service handles the API for unified workflow executions."}],"servers":[{"url":"http://localhost:80"}],"paths":{"/api/orgs/{org}/projects/{project}/unified-executions":{"post":{"tags":["unified-executions"],"summary":"Create unified execution","description":"Create a new unified execution.","operationId":"unified-executions#create-unified-execution","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/UnifiedExecutionRequest2"}}}},"responses":{"200":{"description":"OK response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnifiedExecutionResponse"}}}},"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":{"UnifiedExecutionRequest2":{"type":"object","properties":{"inventories":{"type":"array","items":{"type":"string"},"description":"List of inventory identifiers for ansible execution"},"module_test":{"type":"string","description":"The module test identifier"},"pipeline_execution_id":{"type":"string","description":"The unique identifier for the associated pipeline execution"},"pipeline_id":{"type":"string","description":"The unique identifier for the associated pipeline"},"pipeline_stage_id":{"type":"string","description":"The unique identifier for the associated pipeline stage"},"playbooks":{"type":"array","items":{"type":"string"},"description":"List of playbook identifiers for ansible execution"},"remote_execution_id":{"type":"string","description":"The unique identifier for the remote execution"},"skip_adding_to_db":{"type":"boolean","description":"Skip adding to database"},"webhook":{"$ref":"#/components/schemas/WebhookInfo"},"workspace":{"type":"string","description":"The unique identifier for the associated workspace"}},"required":["pipeline_execution_id","pipeline_stage_id","pipeline_id"]},"WebhookInfo":{"type":"object","properties":{"connector":{"type":"string","description":"The connector for the webhook"},"link":{"type":"string","description":"The link for the webhook"},"repo":{"type":"string","description":"The repository for the webhook"},"type":{"type":"string","description":"The type of the webhook","enum":["pull_request","merged","push","release","tag"]}},"description":"WebhookInfo defines the webhook information for a unified execution","required":["type"]},"UnifiedExecutionResponse":{"type":"object","properties":{"env_variables":{"type":"object","description":"Map of environment variables","additionalProperties":{"type":"string"}},"outputs":{"type":"object","description":"Map of output key-value pairs","additionalProperties":{"type":"string"}},"steps":{"type":"array","items":{"$ref":"#/components/schemas/IACMUnifiedStepWrapper"},"description":"List of execution steps"}},"description":"UnifiedExecutionResponse contains all data required for unified execution","required":["outputs","env_variables"]},"IACMUnifiedStepWrapper":{"type":"object","properties":{"dynamic_fields":{"type":"object","description":"Map of dynamic fields for the step","additionalProperties":{"type":"string"}},"id":{"type":"string","description":"Unique identifier for the step"},"name":{"type":"string","description":"Name of the step"},"yaml":{"type":"string","description":"YAML definition of the step"}},"description":"Wrapper for unified step data","required":["id","name","yaml"]},"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"]}}}}
```