> 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/release-orchestration/api-reference/orchestration-processes-beta.md).

# Orchestration Processes \[Beta]

## Create Orchestration Process

> Create a new orchestration process

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process":{"post":{"description":"Create a new orchestration process","operationId":"PostOrchestrationProcess","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/CreateOrchestrationProcessRequest"},"responses":{"200":{"$ref":"#/components/responses/CreateOrchestrationProcessResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Create Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"CreateOrchestrationProcessRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"yaml":{"description":"YAML configuration for the orchestration process","type":"string"}},"required":["yaml"],"type":"object"}}},"description":"Request to create a new orchestration process"}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"}},"responses":{"CreateOrchestrationProcessResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"identifier":{"description":"Identifier of the created process","type":"string"},"yaml":{"description":"YAML configuration of the process","type":"string"}},"required":["identifier","yaml"],"type":"object"}}},"description":"Response for successful orchestration process creation"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## GET /orchestration/process/summary

> Fetch List of Orchestration Processes

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/summary":{"get":{"operationId":"GetOrchestrationProcessSummary","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"$ref":"#/components/parameters/SearchTermParam"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/Size"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/ProcessIdentifiersParam"}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationProcessSummaryResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Fetch List of Orchestration Processes","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}},"SearchTermParam":{"description":"Optional search string to filter releases by name.","in":"query","name":"searchTerm","schema":{"type":"string"}},"Page":{"in":"query","name":"page","schema":{"type":"integer"}},"Size":{"in":"query","name":"size","schema":{"type":"integer"}},"Sort":{"description":"Sort parameters as an array. Format: `[field_name, direction]` where direction is `asc` or `desc`.\nSupported fields: `start_ts`, `startTs`, `end_ts`, `endTs`, `last_updated_at`, `lastUpdatedAt`, `created_at`, `createdAt`, `name`, `identifier`, `status`, `type`.\nWhen used in query params, use format: `sort=field_name&sort=direction` (e.g., `sort=start_ts&sort=desc`).\n","in":"query","name":"sort","schema":{"items":{"type":"string"},"type":"array"}},"ProcessIdentifiersParam":{"description":"Optional list of process identifiers to filter by. Supports scope prefixes: \"account.<id>\", \"org.<id>\", or plain \"<id>\" (project scope).\n","in":"query","name":"processIdentifiers","schema":{"items":{"type":"string"},"type":"array"}}},"responses":{"OrchestrationProcessSummaryResponse":{"content":{"application/json":{"schema":{"properties":{"content":{"items":{"$ref":"#/components/schemas/OrchestrationProcessMetadataDTO"},"type":"array"},"empty":{"type":"boolean"},"first":{"type":"boolean"},"last":{"type":"boolean"},"number":{"type":"integer"},"numberOfElements":{"type":"integer"},"pageable":{"$ref":"#/components/schemas/Pageable"},"size":{"type":"integer"},"sort":{"$ref":"#/components/schemas/PageableSort"},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["content","pageable","totalPages","last","totalElements","size","number","sort","numberOfElements","first","empty"],"type":"object"}}},"description":"This wraps the list of all orchestration processes along with pagination"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationProcessMetadataDTO":{"properties":{"attachedReleaseGroupCount":{"type":"integer"},"createdAt":{"format":"int64","type":"integer"},"createdBy":{"$ref":"#/components/schemas/CreatedByDTO"},"description":{"type":"string"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"type":"string"},"lastUpdatedAt":{"format":"int64","type":"integer"},"lastUpdatedBy":{"$ref":"#/components/schemas/LastUpdatedByDTO"},"name":{"type":"string"}},"required":["identifier","name","lastUpdatedAt","lastUpdatedBy","createdBy","createdAt","attachedReleaseGroupCount"],"title":"OrchestrationProcessMetadataDTO","type":"object"},"CreatedByDTO":{"description":"Details of the user who created the event","properties":{"email":{"description":"Email of the user who created the event","type":"string"},"identifier":{"description":"Identifier of the user who created the event","type":"string"},"name":{"description":"Name of the user who created the event","type":"string"}},"required":["name","email"],"type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"LastUpdatedByDTO":{"properties":{"email":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"}},"required":["identifier"],"title":"LastUpdatedByDTO","type":"object"},"Pageable":{"properties":{"offset":{"type":"integer"},"pageNumber":{"type":"integer"},"pageSize":{"type":"integer"},"paged":{"type":"boolean"},"sort":{"$ref":"#/components/schemas/PageableSort"},"unpaged":{"type":"boolean"}},"type":"object"},"PageableSort":{"properties":{"empty":{"type":"boolean"},"sorted":{"type":"boolean"},"unsorted":{"type":"boolean"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Get Orchestration Process

> Get orchestration process by identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}":{"get":{"description":"Get orchestration process by identifier","operationId":"GetOrchestrationProcess","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Identifier of the orchestration process","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Optional git branch to fetch the process YAML from (for remote/git-backed processes)","in":"query","name":"git_branch","schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationProcessResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"GetOrchestrationProcessResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML representation of the orchestration process","type":"string"}},"required":["yaml","identifier"],"type":"object"}}},"description":"Response for Get Orchestration Process API"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"CacheResponseMetadata":{"description":"GitX cache metadata returned when fetching a remote entity","properties":{"cache_state":{"description":"Cache freshness state from GitX","enum":["VALID_CACHE","STALE_CACHE","UNKNOWN"],"type":"string"},"is_sync_enabled":{"description":"Whether bi-directional git sync (webhook support) is enabled for the repo","type":"boolean"},"last_updated_at":{"description":"Epoch timestamp of the last cache update","format":"int64","type":"integer"},"ttl_left":{"description":"Remaining TTL for the cached entry in seconds","format":"int64","type":"integer"}},"title":"CacheResponseMetadata","type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Update Orchestration Process

> Update an orchestration process with the provided YAML configuration

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}":{"put":{"description":"Update an orchestration process with the provided YAML configuration","operationId":"PutOrchestrationProcess","parameters":[{"description":"The identifier of the orchestration process to update","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/UpdateOrchestrationProcessRequest"},"responses":{"200":{"$ref":"#/components/responses/UpdateOrchestrationProcessResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Update Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"UpdateOrchestrationProcessRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"yaml":{"type":"string"}},"required":["yaml"],"type":"object"}}},"description":"Request body for updating an orchestration process"}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"}},"responses":{"UpdateOrchestrationProcessResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"identifier":{"description":"Identifier of the updated orchestration process","type":"string"},"yaml":{"description":"YAML configuration of the updated orchestration process","type":"string"}},"required":["identifier","yaml"],"type":"object"}}},"description":"Response for successful orchestration process update"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Delete Orchestration Process

> Delete an orchestration process by identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}":{"delete":{"description":"Delete an orchestration process by identifier","operationId":"DeleteOrchestrationProcess","parameters":[{"description":"The identifier of the orchestration process to delete","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"responses":{"204":{"description":"Orchestration process deleted successfully"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Delete Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Fetch List of Attached Release Groups for Orchestration Process

> Retrieve a paginated list of release groups attached to orchestration processes with optional filtering

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/attachedReleaseGroups":{"post":{"description":"Retrieve a paginated list of release groups attached to orchestration processes with optional filtering","operationId":"PostOrchestrationProcessAttachedReleaseGroups","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/Size"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/SearchTermParam"},{"description":"The identifier of the orchestration process","in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/OrchestrationProcessAttachedReleaseGroupsRequest"},"responses":{"200":{"$ref":"#/components/responses/OrchestrationProcessAttachedReleaseGroupsResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Fetch List of Attached Release Groups for Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}},"Page":{"in":"query","name":"page","schema":{"type":"integer"}},"Size":{"in":"query","name":"size","schema":{"type":"integer"}},"Sort":{"description":"Sort parameters as an array. Format: `[field_name, direction]` where direction is `asc` or `desc`.\nSupported fields: `start_ts`, `startTs`, `end_ts`, `endTs`, `last_updated_at`, `lastUpdatedAt`, `created_at`, `createdAt`, `name`, `identifier`, `status`, `type`.\nWhen used in query params, use format: `sort=field_name&sort=direction` (e.g., `sort=start_ts&sort=desc`).\n","in":"query","name":"sort","schema":{"items":{"type":"string"},"type":"array"}},"SearchTermParam":{"description":"Optional search string to filter releases by name.","in":"query","name":"searchTerm","schema":{"type":"string"}}},"requestBodies":{"OrchestrationProcessAttachedReleaseGroupsRequest":{"content":{"application/json":{"schema":{"properties":{"filterOrgIdentifier":{"description":"Optional organization identifier to filter processes","type":"string"},"filterProjectIdentifier":{"description":"Optional project identifier to filter processes","type":"string"}},"type":"object"}}},"description":"Request body for fetching attached release groups to orchestration processes"}},"responses":{"OrchestrationProcessAttachedReleaseGroupsResponse":{"content":{"application/json":{"schema":{"properties":{"content":{"items":{"$ref":"#/components/schemas/AttachedReleaseGroupDTO"},"type":"array"},"empty":{"type":"boolean"},"first":{"type":"boolean"},"last":{"type":"boolean"},"number":{"type":"integer"},"numberOfElements":{"type":"integer"},"pageable":{"$ref":"#/components/schemas/Pageable"},"size":{"type":"integer"},"sort":{"$ref":"#/components/schemas/PageableSort"},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["content","pageable","totalPages","last","totalElements","size","number","sort","numberOfElements","first","empty"],"type":"object"}}},"description":"Paginated list of release groups attached to orchestration processes"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"AttachedReleaseGroupDTO":{"properties":{"accountIdentifier":{"description":"Account identifier of the release group","type":"string"},"id":{"description":"Unique identifier of the release group","type":"string"},"identifier":{"description":"Release group identifier","type":"string"},"name":{"description":"Name of the release group","type":"string"},"orgIdentifier":{"description":"Organization identifier of the release group","type":"string"},"projectIdentifier":{"description":"Project identifier of the release group","type":"string"}},"required":["id","identifier","name","accountIdentifier"],"title":"AttachedReleaseGroupDTO","type":"object"},"Pageable":{"properties":{"offset":{"type":"integer"},"pageNumber":{"type":"integer"},"pageSize":{"type":"integer"},"paged":{"type":"boolean"},"sort":{"$ref":"#/components/schemas/PageableSort"},"unpaged":{"type":"boolean"}},"type":"object"},"PageableSort":{"properties":{"empty":{"type":"boolean"},"sorted":{"type":"boolean"},"unsorted":{"type":"boolean"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Execute Orchestration Process

> Execute an orchestration process without creating a release (on-the-go execution)

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/execute":{"post":{"description":"Execute an orchestration process without creating a release (on-the-go execution)","operationId":"PostOrchestrationProcessExecute","parameters":[{"description":"The identifier of the orchestration process to execute","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"gitBranch":{"description":"Optional branch to fetch remote process/activity YAMLs from. If omitted, the default branch is used.","type":"string"},"inputIdentifier":{"description":"Process input identifier to use for this execution (required)","type":"string"},"inputYaml":{"description":"Input YAML to configure global and phase inputs for this execution","type":"string"}},"required":["inputIdentifier","inputYaml"],"type":"object"}}},"required":true},"responses":{"200":{"$ref":"#/components/responses/ExecutionStartResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Execute Orchestration Process","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"ExecutionStartResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionStartResponse"}}},"description":"Execution started successfully"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"ExecutionStartResponse":{"description":"Response for starting a release or process execution","properties":{"executionId":{"description":"Navigation slug for the started process execution (on-the-go process execute only)","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"identifier":{"description":"Identifier of the started release or orchestration process","type":"string"},"yaml":{"description":"YAML content of the release or execution input","type":"string"}},"required":["identifier","yaml"],"title":"ExecutionStartResponse","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"}}}}
```

## Get Process Execution History

> Get list of all executions (on-the-go runs) for a specific process

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/executions":{"get":{"description":"Get list of all executions (on-the-go runs) for a specific process","operationId":"GetOrchestrationProcessExecutions","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/Size"},{"$ref":"#/components/parameters/Sort"},{"description":"Filter by execution type (PROCESS for on-the-go executions, RELEASE for release-based executions). If not provided, returns all executions.","in":"query","name":"executionType","schema":{"enum":["PROCESS","RELEASE"],"type":"string"}},{"$ref":"#/components/parameters/OrchestrationExecutionStatusesParam"},{"description":"Filter executions created on or after this timestamp (milliseconds)","in":"query","name":"startTs","schema":{"format":"int64","type":"integer"}},{"description":"Filter executions created on or before this timestamp (milliseconds)","in":"query","name":"endTs","schema":{"format":"int64","type":"integer"}},{"description":"Filter executions by the git branch they were triggered on (remote processes only)","in":"query","name":"git_branch","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"content":{"properties":{"content":{"items":{"$ref":"#/components/schemas/ProcessExecutionDTO"},"type":"array"},"last":{"description":"Whether this is the last page","type":"boolean"},"number":{"description":"Current page number","type":"integer"},"size":{"description":"Page size","type":"integer"},"totalElements":{"description":"Total number of process executions","type":"integer"},"totalPages":{"description":"Total number of pages","type":"integer"}},"required":["content","totalElements","totalPages","size","number"],"type":"object"}},"required":["content"],"type":"object"}}},"description":"Process execution history retrieved successfully"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Process Execution History","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}},"Page":{"in":"query","name":"page","schema":{"type":"integer"}},"Size":{"in":"query","name":"size","schema":{"type":"integer"}},"Sort":{"description":"Sort parameters as an array. Format: `[field_name, direction]` where direction is `asc` or `desc`.\nSupported fields: `start_ts`, `startTs`, `end_ts`, `endTs`, `last_updated_at`, `lastUpdatedAt`, `created_at`, `createdAt`, `name`, `identifier`, `status`, `type`.\nWhen used in query params, use format: `sort=field_name&sort=direction` (e.g., `sort=start_ts&sort=desc`).\n","in":"query","name":"sort","schema":{"items":{"type":"string"},"type":"array"}},"OrchestrationExecutionStatusesParam":{"description":"Filter by execution statuses. Multiple values can be provided to filter by multiple statuses. If not provided, returns all statuses.","in":"query","name":"statuses","schema":{"items":{"enum":["SCHEDULED","RUNNING","OUTPUT_WAITING","PIPELINE_WAITING_FOR_USER_ACTION","QUEUED","SUCCEEDED","FAILED","ABORTED","ON_HOLD","PAUSED","RETRIED","IGNORED","SKIPPED"],"type":"string"},"type":"array"}}},"schemas":{"ProcessExecutionDTO":{"description":"A single execution history row for GET /orchestration/process/{identifier}/executions. Process context comes from the URL path; use executionId to navigate to the execution.\n","properties":{"createdAt":{"description":"Creation timestamp in milliseconds","type":"integer"},"endedAt":{"description":"Execution end timestamp in milliseconds. Omitted while execution is in progress.","type":"integer"},"executionId":{"description":"Navigation ID — process execution slug ID for PROCESS executions, release slug ID for RELEASE executions","type":"string"},"executionType":{"description":"Type of execution","enum":["RELEASE","PROCESS"],"type":"string"},"processIdentifier":{"description":"Identifier of the orchestration process","type":"string"},"processInputIdentifier":{"description":"Process input set identifier used for this execution. Omitted when default values were used.","type":"string"},"processName":{"description":"Display name of the orchestration process","type":"string"},"releaseInfo":{"$ref":"#/components/schemas/ReleaseInfo"},"startedAt":{"description":"Execution start timestamp in milliseconds","type":"integer"},"status":{"$ref":"#/components/schemas/ProcessExecutionStatus"},"triggeredBy":{"$ref":"#/components/schemas/TriggeredByDTO"},"updatedAt":{"description":"Last updated timestamp in milliseconds","type":"integer"}},"required":["status","executionType","startedAt"],"title":"ProcessExecutionDTO","type":"object"},"ReleaseInfo":{"description":"Release metadata. Populated when executionType is RELEASE.","properties":{"identifier":{"description":"Release identifier","type":"string"},"version":{"description":"Release version","type":"string"}},"title":"ReleaseInfo","type":"object"},"ProcessExecutionStatus":{"description":"Release-style execution status","enum":["Running","Success","Failed","Scheduled","Paused","Aborted","InputWaiting"],"title":"ProcessExecutionStatus","type":"string"},"TriggeredByDTO":{"description":"Details of the user who triggered the activity.","properties":{"avatar":{"description":"Avatar URL of the person.","type":"string"},"email":{"description":"Email of the person who triggered the activity.","type":"string"},"id":{"description":"Identifier of the person who triggered the activity.","type":"string"},"name":{"description":"Name of the person who triggered the activity.","type":"string"},"triggerType":{"$ref":"#/components/schemas/TriggerType"}},"type":"object"},"TriggerType":{"description":"Unit of time used for repeating releases.","enum":["MANUAL","WEBHOOK","WEBHOOK_CUSTOM","ARTIFACT","MANIFEST","SCHEDULER_CRON"],"type":"string"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}},"responses":{"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Create Orchestration Process Input

> Create a new orchestration process input with the provided YAML configuration

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/input":{"post":{"description":"Create a new orchestration process input with the provided YAML configuration","operationId":"PostOrchestrationProcessInput","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/CreateOrchestrationProcessInputRequest"},"responses":{"200":{"$ref":"#/components/responses/CreateOrchestrationProcessInputResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Create Orchestration Process Input","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"CreateOrchestrationProcessInputRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"yaml":{"description":"YAML configuration for the orchestration process input","type":"string"}},"required":["yaml"],"type":"object"}}},"description":"Request to create a new orchestration process input"}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}},"responses":{"CreateOrchestrationProcessInputResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML configuration of the process input","type":"string"}},"required":["identifier","yaml"],"type":"object"}}},"description":"Response for successful orchestration process input creation"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Get Orchestration Process Metadata

> Retrieve metadata for an orchestration process without its YAML content

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/metadata":{"get":{"description":"Retrieve metadata for an orchestration process without its YAML content","operationId":"GetOrchestrationProcessMetadata","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Identifier of the orchestration process","in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationProcessMetadataResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Process Metadata","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"OrchestrationProcessMetadataResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationProcessMetadataDTO"}}},"description":"Metadata for a single orchestration process (no YAML)"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationProcessMetadataDTO":{"properties":{"attachedReleaseGroupCount":{"type":"integer"},"createdAt":{"format":"int64","type":"integer"},"createdBy":{"$ref":"#/components/schemas/CreatedByDTO"},"description":{"type":"string"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"type":"string"},"lastUpdatedAt":{"format":"int64","type":"integer"},"lastUpdatedBy":{"$ref":"#/components/schemas/LastUpdatedByDTO"},"name":{"type":"string"}},"required":["identifier","name","lastUpdatedAt","lastUpdatedBy","createdBy","createdAt","attachedReleaseGroupCount"],"title":"OrchestrationProcessMetadataDTO","type":"object"},"CreatedByDTO":{"description":"Details of the user who created the event","properties":{"email":{"description":"Email of the user who created the event","type":"string"},"identifier":{"description":"Identifier of the user who created the event","type":"string"},"name":{"description":"Name of the user who created the event","type":"string"}},"required":["name","email"],"type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"LastUpdatedByDTO":{"properties":{"email":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"}},"required":["identifier"],"title":"LastUpdatedByDTO","type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Move Orchestration Process to Git

> Move an inline orchestration process to a remote git repository. Processes already stored remotely cannot be moved. Existing process inputs are left unchanged (may remain INLINE).<br>

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{identifier}/move-config":{"post":{"description":"Move an inline orchestration process to a remote git repository. Processes already stored remotely cannot be moved. Existing process inputs are left unchanged (may remain INLINE).\n","operationId":"MoveOrchestrationProcessToGit","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"The identifier of the orchestration process to move","in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/MoveOrchestrationProcessToGitRequest"},"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationProcessResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"},"502":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Move Orchestration Process to Git","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"MoveOrchestrationProcessToGitRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"}},"required":["git_details"],"type":"object"}}},"description":"Request body for moving an inline orchestration process to git. The existing inline YAML is relocated unchanged. Process inputs are not moved."}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"CacheResponseMetadata":{"description":"GitX cache metadata returned when fetching a remote entity","properties":{"cache_state":{"description":"Cache freshness state from GitX","enum":["VALID_CACHE","STALE_CACHE","UNKNOWN"],"type":"string"},"is_sync_enabled":{"description":"Whether bi-directional git sync (webhook support) is enabled for the repo","type":"boolean"},"last_updated_at":{"description":"Epoch timestamp of the last cache update","format":"int64","type":"integer"},"ttl_left":{"description":"Remaining TTL for the cached entry in seconds","format":"int64","type":"integer"}},"title":"CacheResponseMetadata","type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}},"responses":{"GetOrchestrationProcessResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML representation of the orchestration process","type":"string"}},"required":["yaml","identifier"],"type":"object"}}},"description":"Response for Get Orchestration Process API"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Fetch List of Orchestration Process Inputs

> Retrieve a paginated list of orchestration process inputs for a specific process

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/summary":{"get":{"description":"Retrieve a paginated list of orchestration process inputs for a specific process","operationId":"GetOrchestrationProcessInputSummary","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/Size"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/SearchTermParam"}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationProcessInputSummaryResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Fetch List of Orchestration Process Inputs","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}},"Page":{"in":"query","name":"page","schema":{"type":"integer"}},"Size":{"in":"query","name":"size","schema":{"type":"integer"}},"Sort":{"description":"Sort parameters as an array. Format: `[field_name, direction]` where direction is `asc` or `desc`.\nSupported fields: `start_ts`, `startTs`, `end_ts`, `endTs`, `last_updated_at`, `lastUpdatedAt`, `created_at`, `createdAt`, `name`, `identifier`, `status`, `type`.\nWhen used in query params, use format: `sort=field_name&sort=direction` (e.g., `sort=start_ts&sort=desc`).\n","in":"query","name":"sort","schema":{"items":{"type":"string"},"type":"array"}},"SearchTermParam":{"description":"Optional search string to filter releases by name.","in":"query","name":"searchTerm","schema":{"type":"string"}}},"responses":{"OrchestrationProcessInputSummaryResponse":{"content":{"application/json":{"schema":{"properties":{"content":{"items":{"$ref":"#/components/schemas/OrchestrationProcessInputMetadataDTO"},"type":"array"},"empty":{"type":"boolean"},"first":{"type":"boolean"},"last":{"type":"boolean"},"number":{"type":"integer"},"numberOfElements":{"type":"integer"},"pageable":{"$ref":"#/components/schemas/Pageable"},"size":{"type":"integer"},"sort":{"$ref":"#/components/schemas/PageableSort"},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"}},"required":["content","pageable","totalPages","last","totalElements","size","number","sort","numberOfElements","first","empty"],"type":"object"}}},"description":"Paginated list of orchestration process inputs"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationProcessInputMetadataDTO":{"properties":{"description":{"type":"string"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"type":"string"},"lastUpdatedAt":{"format":"int64","type":"integer"},"lastUpdatedBy":{"$ref":"#/components/schemas/LastUpdatedByDTO"},"name":{"type":"string"},"status":{"enum":["Incomplete","Configured"],"type":"string"}},"required":["identifier","name","lastUpdatedAt","lastUpdatedBy","status"],"title":"OrchestrationProcessInputMetadataDTO","type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"LastUpdatedByDTO":{"properties":{"email":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"}},"required":["identifier"],"title":"LastUpdatedByDTO","type":"object"},"Pageable":{"properties":{"offset":{"type":"integer"},"pageNumber":{"type":"integer"},"pageSize":{"type":"integer"},"paged":{"type":"boolean"},"sort":{"$ref":"#/components/schemas/PageableSort"},"unpaged":{"type":"boolean"}},"type":"object"},"PageableSort":{"properties":{"empty":{"type":"boolean"},"sorted":{"type":"boolean"},"unsorted":{"type":"boolean"}},"type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Get Orchestration Process Input

> Get an orchestration process input by process identifier and input identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{identifier}":{"get":{"description":"Get an orchestration process input by process identifier and input identifier","operationId":"GetOrchestrationProcessInput","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"The identifier of the orchestration process input","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Optional git branch to fetch the process input YAML from (for remote/git-backed process inputs)","in":"query","name":"git_branch","schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationProcessInputResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Process Input","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"GetOrchestrationProcessInputResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration process input","type":"string"},"processIdentifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML configuration of the orchestration process input","type":"string"}},"required":["identifier","yaml","processIdentifier"],"type":"object"}}},"description":"Response for successful orchestration process input retrieval"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"CacheResponseMetadata":{"description":"GitX cache metadata returned when fetching a remote entity","properties":{"cache_state":{"description":"Cache freshness state from GitX","enum":["VALID_CACHE","STALE_CACHE","UNKNOWN"],"type":"string"},"is_sync_enabled":{"description":"Whether bi-directional git sync (webhook support) is enabled for the repo","type":"boolean"},"last_updated_at":{"description":"Epoch timestamp of the last cache update","format":"int64","type":"integer"},"ttl_left":{"description":"Remaining TTL for the cached entry in seconds","format":"int64","type":"integer"}},"title":"CacheResponseMetadata","type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Update Orchestration Process Input

> Update an orchestration process input with the provided YAML configuration

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{identifier}":{"put":{"description":"Update an orchestration process input with the provided YAML configuration","operationId":"PutOrchestrationProcessInput","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"The identifier of the orchestration process input to update","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/UpdateOrchestrationProcessInputRequest"},"responses":{"200":{"$ref":"#/components/responses/UpdateOrchestrationProcessInputResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Update Orchestration Process Input","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"UpdateOrchestrationProcessInputRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"yaml":{"description":"YAML configuration for the orchestration process input","type":"string"}},"required":["yaml"],"type":"object"}}},"description":"Request to update an orchestration process input"}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}},"responses":{"UpdateOrchestrationProcessInputResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the updated orchestration process input","type":"string"},"processIdentifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML configuration of the updated orchestration process input","type":"string"}},"required":["identifier","yaml","processIdentifier"],"type":"object"}}},"description":"Response for successful orchestration process input update"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Delete Orchestration Process Input

> Delete an orchestration process input by process identifier and input identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{identifier}":{"delete":{"description":"Delete an orchestration process input by process identifier and input identifier","operationId":"DeleteOrchestrationProcessInput","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"The identifier of the orchestration process input to delete","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"responses":{"204":{"description":"Orchestration process input deleted successfully"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Delete Orchestration Process Input","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Move Orchestration Process Input to Git

> Move an inline process input to a remote git repository. Parent process must be remote. Input already stored remotely cannot be moved. Git repository and connector must match the parent process. Branch is required but is not validated against a process-pinned branch (processes do not persist a branch; Save-to-Git may commit to a new branch).<br>

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{identifier}/move-config":{"post":{"description":"Move an inline process input to a remote git repository. Parent process must be remote. Input already stored remotely cannot be moved. Git repository and connector must match the parent process. Branch is required but is not validated against a process-pinned branch (processes do not persist a branch; Save-to-Git may commit to a new branch).\n","operationId":"MoveOrchestrationProcessInputToGit","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"The identifier of the orchestration process input","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/MoveOrchestrationProcessInputToGitRequest"},"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationProcessInputResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"},"502":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Move Orchestration Process Input to Git","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"requestBodies":{"MoveOrchestrationProcessInputToGitRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"}},"required":["git_details"],"type":"object"}}},"description":"Move an inline orchestration process input to git. Parent process must already be remote. Git coordinates must match the process. Existing inline YAML is relocated unchanged.\n"}},"schemas":{"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"CacheResponseMetadata":{"description":"GitX cache metadata returned when fetching a remote entity","properties":{"cache_state":{"description":"Cache freshness state from GitX","enum":["VALID_CACHE","STALE_CACHE","UNKNOWN"],"type":"string"},"is_sync_enabled":{"description":"Whether bi-directional git sync (webhook support) is enabled for the repo","type":"boolean"},"last_updated_at":{"description":"Epoch timestamp of the last cache update","format":"int64","type":"integer"},"ttl_left":{"description":"Remaining TTL for the cached entry in seconds","format":"int64","type":"integer"}},"title":"CacheResponseMetadata","type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}},"responses":{"GetOrchestrationProcessInputResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration process input","type":"string"},"processIdentifier":{"description":"Identifier of the orchestration process","type":"string"},"yaml":{"description":"YAML configuration of the orchestration process input","type":"string"}},"required":["identifier","yaml","processIdentifier"],"type":"object"}}},"description":"Response for successful orchestration process input retrieval"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Validate Orchestration Process Input

> On-demand cross-entity validation for a process input. Checks that all activity \`with\` keys are recognised (X4 warning) and that all required activity inputs are covered (X5 error). Returns HTTP 200 with a validation report regardless of outcome — never modifies any state.

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{identifier}/validate":{"post":{"description":"On-demand cross-entity validation for a process input. Checks that all activity `with` keys are recognised (X4 warning) and that all required activity inputs are covered (X5 error). Returns HTTP 200 with a validation report regardless of outcome — never modifies any state.","operationId":"PostOrchestrationProcessInputValidate","parameters":[{"description":"The identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"The identifier of the orchestration process input","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"responses":{"200":{"$ref":"#/components/responses/ValidateOrchestrationProcessInputResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Validate Orchestration Process Input","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"ValidateOrchestrationProcessInputResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessInputValidationResponse"}}},"description":"Result of an on-demand process input cross-entity validation"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"ProcessInputValidationResponse":{"description":"Result of an on-demand process input cross-entity validation (X4/X5)","properties":{"errors":{"description":"Blocking validation errors (e.g. required activity inputs not covered by with values)","items":{"type":"string"},"type":"array"},"warnings":{"description":"Non-blocking validation warnings (e.g. with keys not present in activity inputs definitions)","items":{"type":"string"},"type":"array"}},"required":["errors","warnings"],"title":"ProcessInputValidationResponse","type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```

## Get Orchestration Process Input Metadata

> Retrieve metadata for an orchestration process input without its YAML content

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Processes"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/process/{processIdentifier}/input/{inputIdentifier}/metadata":{"get":{"description":"Retrieve metadata for an orchestration process input without its YAML content","operationId":"GetOrchestrationProcessInputMetadata","parameters":[{"description":"Identifier of the orchestration process","in":"path","name":"processIdentifier","required":true,"schema":{"type":"string"}},{"description":"Identifier of the orchestration process input","in":"path","name":"inputIdentifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationProcessInputMetadataResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Process Input Metadata","tags":["Orchestration Processes"]}}},"components":{"parameters":{"AccountParam":{"description":"Account Identifier","in":"header","name":"Harness-Account","required":true,"schema":{"type":"string"}},"OrgParam":{"description":"Organisation Identifier","in":"query","name":"orgIdentifier","schema":{"type":"string"}},"ProjectParam":{"description":"Project Identifier","in":"query","name":"projectIdentifier","schema":{"type":"string"}}},"responses":{"OrchestrationProcessInputMetadataResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationProcessInputMetadataDTO"}}},"description":"Metadata for a single orchestration process input (no YAML)"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationProcessInputMetadataDTO":{"properties":{"description":{"type":"string"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"type":"string"},"lastUpdatedAt":{"format":"int64","type":"integer"},"lastUpdatedBy":{"$ref":"#/components/schemas/LastUpdatedByDTO"},"name":{"type":"string"},"status":{"enum":["Incomplete","Configured"],"type":"string"}},"required":["identifier","name","lastUpdatedAt","lastUpdatedBy","status"],"title":"OrchestrationProcessInputMetadataDTO","type":"object"},"GitDetails":{"description":"Git metadata associated with an orchestration activity stored in a remote git repository","properties":{"base_branch":{"description":"Base branch to create the new branch from","type":"string"},"branch":{"description":"Git branch where the activity YAML resides","type":"string"},"commit_msg":{"description":"Commit message to use when saving to git","type":"string"},"connector_ref":{"description":"Connector reference for the git provider","type":"string"},"file_url":{"description":"Navigable URL to the file in the git repository","type":"string"},"is_new_branch":{"description":"Whether to create a new branch when saving","type":"boolean"},"path":{"description":"File path within the git repository","type":"string"},"repo":{"description":"Git repository URL where the activity YAML is stored","type":"string"},"store_type":{"$ref":"#/components/schemas/StoreType"}},"title":"GitDetails","type":"object"},"StoreType":{"description":"Storage type indicating whether the entity is stored inline or in a remote git repository.","enum":["INLINE","REMOTE"],"type":"string"},"LastUpdatedByDTO":{"properties":{"email":{"type":"string"},"identifier":{"type":"string"},"name":{"type":"string"}},"required":["identifier"],"title":"LastUpdatedByDTO","type":"object"},"Error":{"description":"Error Response","properties":{"code":{"description":"canonical error code name","enum":["BAD_REQUEST","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"type":"string"},"explanation":{"description":"additional context about why the error occurred","type":"string"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"message":{"description":"error message detail","type":"string"},"probable_fixes":{"description":"suggested actions to resolve the error","items":{"type":"string"},"type":"array"}},"required":["message"],"title":"Error Response","type":"object"},"GovernanceMetadata":{"properties":{"accountId":{"type":"string"},"action":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"details":{"items":{"$ref":"#/components/schemas/PolicySetMetadata"},"type":"array"},"entity":{"type":"string"},"id":{"type":"string"},"message":{"type":"string"},"orgId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PolicySetMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"deny":{"type":"boolean"},"description":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyMetadata":{"items":{"$ref":"#/components/schemas/PolicyMetadata"},"type":"array"},"policySetId":{"type":"string"},"policySetName":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string"}},"type":"object"},"PolicyMetadata":{"properties":{"accountId":{"type":"string"},"created":{"type":"string"},"denyMessages":{"items":{"type":"string"},"type":"array"},"error":{"type":"string"},"identifier":{"type":"string"},"orgId":{"type":"string"},"policyId":{"type":"string"},"policyName":{"type":"string"},"projectId":{"type":"string"},"severity":{"type":"string"},"status":{"type":"string"},"updated":{"type":"string"}},"type":"object"}}}}
```