> 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-activities-beta.md).

# Orchestration Activities \[Beta]

## Create Orchestration Activity

> Create a new orchestration activity

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity":{"post":{"description":"Create a new orchestration activity","operationId":"PostOrchestrationActivity","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/CreateOrchestrationActivityRequest"},"responses":{"200":{"$ref":"#/components/responses/CreateOrchestrationActivityResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Create Orchestration Activity","tags":["Orchestration Activities"]}}},"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":{"CreateOrchestrationActivityRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"yaml":{"type":"string"}},"required":["yaml"],"type":"object"}}},"description":"Request body for creating an orchestration activity"}},"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":{"CreateOrchestrationActivityResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"identifier":{"type":"string"},"yaml":{"type":"string"}},"required":["identifier","yaml"],"type":"object"}}},"description":"Response for successful orchestration activity creation"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Get Orchestration Activities by activity refs

> Get orchestration activities for specific activity refs

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/list":{"post":{"description":"Get orchestration activities for specific activity refs","operationId":"GetOrchestrationActivitiesByAcitivityRefs","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"description":"Optional git branch to fetch remote activity YAMLs from","in":"query","name":"git_branch","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"activityGitBranches":{"additionalProperties":{"type":"string"},"description":"Optional map of activityRef to git branch. Keys must be entries from activityRefs. When omitted for a ref, the git_branch query parameter or the activity's default branch is used.\n","type":"object"},"activityRefs":{"description":"Array of activity references","items":{"type":"string"},"type":"array"}},"required":["activityRefs"],"type":"object"}}},"required":true},"responses":{"200":{"$ref":"#/components/responses/OrchestrationActivityListByProcessIdentifierResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Activities by activity refs","tags":["Orchestration Activities"]}}},"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"}},"Cursor":{"description":"Cursor Based Pagination","in":"query","name":"cursor","schema":{"type":"string"}},"Limit":{"description":"The number of records expected","in":"query","name":"limit","schema":{"default":500,"maximum":500,"type":"number"}}},"responses":{"OrchestrationActivityListByProcessIdentifierResponse":{"content":{"application/json":{"schema":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/OrchestrationActivityYamlDto"},"type":"array"},"last":{"description":"Whether this is the last page of results","type":"boolean"},"nextRequest":{"$ref":"#/components/schemas/NextRequest"}},"required":["activities","nextRequest","last"],"type":"object"}}},"description":"Response for listing orchestration activities by process identifer"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationActivityYamlDto":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"identifier":{"description":"Identifier of the activity","type":"string"},"orgIdentifier":{"description":"Organization identifier of the activity","type":"string"},"projectIdentifier":{"description":"Project identifier of the activity","type":"string"},"type":{"$ref":"#/components/schemas/CreateOrchestrationActivityRequestType"},"yaml":{"description":"YAML configuration of the activity","type":"string"}},"required":["identifier","yaml"],"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"},"CreateOrchestrationActivityRequestType":{"description":"Type of orchestration activity","enum":["PIPELINE","MANUAL","SUBPROCESS","PIPELINE_QUEUE"],"type":"string"},"NextRequest":{"properties":{"cursor":{"type":"string"},"limit":{"type":"integer"}},"type":"object"}}}}
```

## List Orchestration Activities by Process Identifier

> Retrieve a paginated list of orchestration activities for a specific process identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/processIdentifier/{identifier}":{"get":{"description":"Retrieve a paginated list of orchestration activities for a specific process identifier","operationId":"GetOrchestrationActivitiesByProcessIdentifier","parameters":[{"description":"The process identifier","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Optional phase identifier to filter activities","in":"query","name":"phaseIdentifier","schema":{"type":"string"}},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationActivityListByProcessIdentifierResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"List Orchestration Activities by Process Identifier","tags":["Orchestration Activities"]}}},"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"}},"Cursor":{"description":"Cursor Based Pagination","in":"query","name":"cursor","schema":{"type":"string"}},"Limit":{"description":"The number of records expected","in":"query","name":"limit","schema":{"default":500,"maximum":500,"type":"number"}}},"responses":{"OrchestrationActivityListByProcessIdentifierResponse":{"content":{"application/json":{"schema":{"properties":{"activities":{"items":{"$ref":"#/components/schemas/OrchestrationActivityYamlDto"},"type":"array"},"last":{"description":"Whether this is the last page of results","type":"boolean"},"nextRequest":{"$ref":"#/components/schemas/NextRequest"}},"required":["activities","nextRequest","last"],"type":"object"}}},"description":"Response for listing orchestration activities by process identifer"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationActivityYamlDto":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"identifier":{"description":"Identifier of the activity","type":"string"},"orgIdentifier":{"description":"Organization identifier of the activity","type":"string"},"projectIdentifier":{"description":"Project identifier of the activity","type":"string"},"type":{"$ref":"#/components/schemas/CreateOrchestrationActivityRequestType"},"yaml":{"description":"YAML configuration of the activity","type":"string"}},"required":["identifier","yaml"],"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"},"CreateOrchestrationActivityRequestType":{"description":"Type of orchestration activity","enum":["PIPELINE","MANUAL","SUBPROCESS","PIPELINE_QUEUE"],"type":"string"},"NextRequest":{"properties":{"cursor":{"type":"string"},"limit":{"type":"integer"}},"type":"object"}}}}
```

## Resolve orchestration activities for a process

> Resolve activity YAML for process activity instances in a single phase with correct per-instance git branch resolution (activity pin → same-repo process branch → activity default). phaseIdentifier is required so the response map can be keyed by activity instance id. When activityDetails is omitted, instances are collected from the persisted process YAML for that phase. When activityDetails is provided (e.g. unsaved studio edits), each entry must include identifier and activityRef. If the process is not found and activityDetails is provided, resolution continues using optional processGitRepo/processBranch from the request. If the process exists and processGitRepo is sent, it must match the stored repo.<br>

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/resolve-for-process":{"post":{"description":"Resolve activity YAML for process activity instances in a single phase with correct per-instance git branch resolution (activity pin → same-repo process branch → activity default). phaseIdentifier is required so the response map can be keyed by activity instance id. When activityDetails is omitted, instances are collected from the persisted process YAML for that phase. When activityDetails is provided (e.g. unsaved studio edits), each entry must include identifier and activityRef. If the process is not found and activityDetails is provided, resolution continues using optional processGitRepo/processBranch from the request. If the process exists and processGitRepo is sent, it must match the stored repo.\n","operationId":"ResolveOrchestrationActivitiesForProcess","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveOrchestrationActivitiesForProcessRequest"}}},"required":true},"responses":{"200":{"$ref":"#/components/responses/ResolveOrchestrationActivitiesForProcessResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Resolve orchestration activities for a process","tags":["Orchestration Activities"]}}},"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"}}},"schemas":{"ResolveOrchestrationActivitiesForProcessRequest":{"properties":{"activityDetails":{"description":"Optional process activity instances to resolve. When provided (including an empty array), these instances are used instead of reading persisted process YAML. Each entry requires identifier and activityRef.\n","items":{"$ref":"#/components/schemas/ResolveProcessActivityDetail"},"type":"array"},"phaseIdentifier":{"description":"Phase whose activity instances are being resolved. Required so response map keys (process activity instance ids) are unique within the phase.\n","minLength":1,"type":"string"},"processBranch":{"description":"Branch the process YAML was loaded from; used for same-repo activity branch inherit","type":"string"},"processGitRepo":{"description":"Optional git repository of the process for same-repo activity branch inherit. Use when the process is not yet persisted (e.g. new studio process) or to supply repo context alongside processBranch. When the process exists in the database and this field is set, it must match the process's stored git repo.\n","type":"string"},"processIdentifier":{"description":"Identifier of the process used for git repo context and (when activityDetails is omitted) instance collection","type":"string"}},"required":["processIdentifier","phaseIdentifier"],"type":"object"},"ResolveProcessActivityDetail":{"properties":{"activityBranch":{"description":"Optional gitBranch pin from process YAML for this instance","type":"string"},"activityRef":{"description":"Activity entity reference (YAML activity field)","minLength":1,"type":"string"},"identifier":{"description":"Process activity instance id (YAML id)","minLength":1,"type":"string"}},"required":["identifier","activityRef"],"type":"object"},"OrchestrationActivityYamlDto":{"properties":{"error":{"$ref":"#/components/schemas/Error"},"identifier":{"description":"Identifier of the activity","type":"string"},"orgIdentifier":{"description":"Organization identifier of the activity","type":"string"},"projectIdentifier":{"description":"Project identifier of the activity","type":"string"},"type":{"$ref":"#/components/schemas/CreateOrchestrationActivityRequestType"},"yaml":{"description":"YAML configuration of the activity","type":"string"}},"required":["identifier","yaml"],"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"},"CreateOrchestrationActivityRequestType":{"description":"Type of orchestration activity","enum":["PIPELINE","MANUAL","SUBPROCESS","PIPELINE_QUEUE"],"type":"string"}},"responses":{"ResolveOrchestrationActivitiesForProcessResponse":{"content":{"application/json":{"schema":{"properties":{"activities":{"additionalProperties":{"$ref":"#/components/schemas/OrchestrationActivityYamlDto"},"description":"Map keyed by process activity instance identifier (YAML id) within the requested phase.\n","type":"object"}},"required":["activities"],"type":"object"}}},"description":"Map of process activity instance identifier to resolved activity details"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Fetch List of Orchestration Activities

> Retrieve a paginated list of orchestration activities

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/summary":{"get":{"description":"Retrieve a paginated list of orchestration activities","operationId":"GetOrchestrationActivitySummary","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"}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationActivitySummaryResponse"},"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 Activities","tags":["Orchestration Activities"]}}},"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":{"OrchestrationActivitySummaryResponse":{"content":{"application/json":{"schema":{"properties":{"content":{"items":{"$ref":"#/components/schemas/OrchestrationActivityMetadataDTO"},"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 activities"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationActivityMetadataDTO":{"properties":{"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"},"type":{"$ref":"#/components/schemas/CreateOrchestrationActivityRequestType"}},"required":["identifier","name","type","lastUpdatedAt","lastUpdatedBy","createdBy","createdAt"],"title":"OrchestrationActivityMetadataDTO","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"},"CreateOrchestrationActivityRequestType":{"description":"Type of orchestration activity","enum":["PIPELINE","MANUAL","SUBPROCESS","PIPELINE_QUEUE"],"type":"string"},"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"}}}}
```

## Handle On-Hold Activity Action

> Process actions (retry/ignore) for activities in ON\_HOLD state

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{activityExecutionId}/onhold/action":{"post":{"description":"Process actions (retry/ignore) for activities in ON_HOLD state","operationId":"PostOnHoldActivityAction","parameters":[{"description":"The ID of the activity execution","in":"path","name":"activityExecutionId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"requestBody":{"$ref":"#/components/requestBodies/OnHoldActivityActionRequest"},"responses":{"200":{"$ref":"#/components/responses/OnHoldActivityActionResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Handle On-Hold Activity Action","tags":["Orchestration Activities"]}}},"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":{"OnHoldActivityActionRequest":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnHoldActivityActionRequest"}}},"required":true}},"schemas":{"OnHoldActivityActionRequest":{"properties":{"action":{"description":"The action to perform on the on-hold activity. Must be 'retry' if retryWith is present.","enum":["retry","ignore"],"type":"string"},"inputs":{"description":"Optional list of input values for retrying the on-hold activity. Only valid when action is 'retry'.","items":{"$ref":"#/components/schemas/ActivityExecutionInputDTO"},"type":"array"},"outputs":{"description":"Optional list of output values for ignoring the on-hold activity. Only valid when action is 'ignore'.","items":{"$ref":"#/components/schemas/ExecutionOutputDTO"},"type":"array"},"retryWith":{"description":"Specifies the retry mechanism. If present, action must be 'retry'. Currently only SUBPROCESS is supported.","enum":["SUBPROCESS"],"type":"string"},"subprocessInfo":{"$ref":"#/components/schemas/SubprocessInfo"}},"required":["action"],"type":"object"},"ActivityExecutionInputDTO":{"description":"Input value for an activity execution","properties":{"metadata":{"additionalProperties":true,"description":"Free-form metadata bag persisted alongside the input value. release-artifact inputs use it to carry commitSha/repoName/branch/registry/artifactPath so the execution view can render them without a second lookup.\n","type":"object"},"name":{"description":"Name of the input parameter","type":"string"},"optional":{"description":"When true this input may be left blank at retry time; when false it must have a non-blank value","type":"boolean"},"readOnly":{"description":"When true this input cannot be changed at retry time","type":"boolean"},"type":{"$ref":"#/components/schemas/InputVariableType"},"value":{"$ref":"#/components/schemas/AnyValue"}},"required":["name","value","type"],"type":"object"},"InputVariableType":{"description":"Type of an input variable for parameters and process inputs.","enum":["string","list","boolean","number","object","service","multiService","environment","multiEnvironment","infrastructure","multiInfrastructure","connector","userGroups","artifactTag","release-artifact"],"type":"string"},"AnyValue":{"description":"Flexible type that accepts any JSON value (string, number, boolean, object, or array)","oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"additionalProperties":true,"type":"object"},{"items":{"type":"object"},"type":"array"}]},"ExecutionOutputDTO":{"description":"Output value for a phase execution","properties":{"description":{"description":"Description of the output parameter","type":"string"},"items":{"$ref":"#/components/schemas/OutputDataType"},"name":{"description":"Name of the output parameter","type":"string"},"type":{"$ref":"#/components/schemas/OutputDataType"},"value":{"$ref":"#/components/schemas/AnyValue"}},"required":["name","value"],"type":"object"},"OutputDataType":{"description":"Declared type of a Phase or Activity output.\nAbsent (empty) means the output has no declared type and is treated as 'string' for backward compatibility.\n","enum":["string","boolean","number","list","release-artifact"],"type":"string"},"SubprocessInfo":{"properties":{"output":{"additionalProperties":{"type":"string"},"description":"Output map with key-value pairs.","type":"object"},"processIdentifier":{"description":"Process identifier. Required when retryWith is SUBPROCESS.","type":"string"},"processInputIdentifier":{"description":"Process input identifier. Required when retryWith is SUBPROCESS.","type":"string"},"releaseInput":{"description":"Release input YAML. Required when retryWith is SUBPROCESS.","type":"string"}},"required":["processIdentifier","processInputIdentifier","releaseInput","output"],"type":"object"},"OnHoldActivityActionResponse":{"properties":{"action":{"description":"The action that was performed","type":"string"},"activityExecutionId":{"description":"The ID of the processed activity execution","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"},"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":{"OnHoldActivityActionResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnHoldActivityActionResponse"}}},"description":"On-hold activity action processed successfully"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Get Activity Inputs by Activity Ref

> Retrieve input definitions and values for a specific activity within a process input configuration

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{activityRef}/inputs":{"get":{"description":"Retrieve input definitions and values for a specific activity within a process input configuration","operationId":"GetOrchestrationActivityInputs","parameters":[{"description":"The referred activity in process yaml","in":"path","name":"activityRef","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"}],"responses":{"200":{"$ref":"#/components/responses/ActivityInputsResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Activity Inputs by Activity Ref","tags":["Orchestration Activities"]}}},"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":{"ActivityInputsResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityInputsResponse"}}},"description":"Response containing activity input definitions with their values and metadata"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"ActivityInputsResponse":{"description":"Enhanced response structure for activity inputs","properties":{"activityInput":{"description":"activityInput Yaml string","type":"string"}},"required":["activityInput"],"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 Activity

> Get orchestration activity by identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{identifier}":{"get":{"description":"Get orchestration activity by identifier","operationId":"GetOrchestrationActivity","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Identifier of the orchestration activity","in":"path","name":"identifier","required":true,"schema":{"type":"string"}},{"description":"Optional git branch to fetch the activity YAML from (for remote/git-backed activities)","in":"query","name":"git_branch","schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationActivityResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Activity","tags":["Orchestration Activities"]}}},"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":{"GetOrchestrationActivityResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration activity","type":"string"},"yaml":{"description":"YAML representation of the orchestration activity","type":"string"}},"required":["yaml","identifier"],"type":"object"}}},"description":"Response for Get Orchestration Activity 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 Activity

> Update an orchestration activity with the provided YAML configuration

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{identifier}":{"put":{"description":"Update an orchestration activity with the provided YAML configuration","operationId":"PutOrchestrationActivity","parameters":[{"description":"The identifier of the orchestration activity 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/UpdateOrchestrationActivityRequest"},"responses":{"200":{"$ref":"#/components/responses/UpdateOrchestrationActivityResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Update Orchestration Activity","tags":["Orchestration Activities"]}}},"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":{"UpdateOrchestrationActivityRequest":{"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 activity"}},"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":{"UpdateOrchestrationActivityResponse":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"},"governanceMetadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"identifier":{"description":"Identifier of the updated orchestration activity","type":"string"},"yaml":{"description":"YAML configuration of the updated orchestration activity","type":"string"}},"required":["identifier","yaml"],"type":"object"}}},"description":"Response for successful orchestration activity update"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```

## Delete Orchestration Activity

> Delete an orchestration activity by identifier

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{identifier}":{"delete":{"description":"Delete an orchestration activity by identifier","operationId":"DeleteOrchestrationActivity","parameters":[{"description":"The identifier of the orchestration activity 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 activity 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 Activity","tags":["Orchestration Activities"]}}},"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"}}}}
```

## Get Orchestration Activity Metadata

> Retrieve metadata for an orchestration activity without its YAML content

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{identifier}/metadata":{"get":{"description":"Retrieve metadata for an orchestration activity without its YAML content","operationId":"GetOrchestrationActivityMetadata","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"Identifier of the orchestration activity","in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/OrchestrationActivityMetadataResponse"},"400":{"$ref":"#/components/responses/ErrorResponse"},"403":{"$ref":"#/components/responses/ErrorResponse"},"404":{"$ref":"#/components/responses/ErrorResponse"},"500":{"$ref":"#/components/responses/ErrorResponse"}},"summary":"Get Orchestration Activity Metadata","tags":["Orchestration Activities"]}}},"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":{"OrchestrationActivityMetadataResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationActivityMetadataDTO"}}},"description":"Metadata for a single orchestration activity (no YAML)"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}},"schemas":{"OrchestrationActivityMetadataDTO":{"properties":{"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"},"type":{"$ref":"#/components/schemas/CreateOrchestrationActivityRequestType"}},"required":["identifier","name","type","lastUpdatedAt","lastUpdatedBy","createdBy","createdAt"],"title":"OrchestrationActivityMetadataDTO","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"},"CreateOrchestrationActivityRequestType":{"description":"Type of orchestration activity","enum":["PIPELINE","MANUAL","SUBPROCESS","PIPELINE_QUEUE"],"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"}}}}
```

## Move Orchestration Activity to Git

> Move an inline orchestration activity to a remote git repository. Activities already stored remotely cannot be moved.

```json
{"openapi":"3.0.0","info":{"title":"rms","version":"1.0"},"tags":[{"name":"Orchestration Activities"}],"servers":[{"url":"/api"}],"paths":{"/orchestration/activity/{identifier}/move-config":{"post":{"description":"Move an inline orchestration activity to a remote git repository. Activities already stored remotely cannot be moved.","operationId":"MoveOrchestrationActivityToGit","parameters":[{"$ref":"#/components/parameters/AccountParam"},{"$ref":"#/components/parameters/OrgParam"},{"$ref":"#/components/parameters/ProjectParam"},{"description":"The identifier of the orchestration activity to move","in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/MoveOrchestrationActivityToGitRequest"},"responses":{"200":{"$ref":"#/components/responses/GetOrchestrationActivityResponse"},"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 Activity to Git","tags":["Orchestration Activities"]}}},"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":{"MoveOrchestrationActivityToGitRequest":{"content":{"application/json":{"schema":{"properties":{"git_details":{"$ref":"#/components/schemas/GitDetails"}},"required":["git_details"],"type":"object"}}},"description":"Request body for moving an inline orchestration activity to git. The existing inline YAML is relocated unchanged."}},"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":{"GetOrchestrationActivityResponse":{"content":{"application/json":{"schema":{"properties":{"cache_response":{"$ref":"#/components/schemas/CacheResponseMetadata"},"git_details":{"$ref":"#/components/schemas/GitDetails"},"identifier":{"description":"Identifier of the orchestration activity","type":"string"},"yaml":{"description":"YAML representation of the orchestration activity","type":"string"}},"required":["yaml","identifier"],"type":"object"}}},"description":"Response for Get Orchestration Activity API"},"ErrorResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Error Response body"}}}}
```