---
title: "Get Harbor Action Execution"
method: GET
path: "/api/harbors/{harbor_id}/action-executions/{execution_id}"
tags: ["Harbors"]
---

# Get Harbor Action Execution

`GET /api/harbors/{harbor_id}/action-executions/{execution_id}`

## Request

- Base URL: `https://app.polytomic.com`
- URL: `https://app.polytomic.com/api/harbors/{harbor_id}/action-executions/{execution_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Read a metadata-only action receipt without resubmitting the action.

Use a currently valid scoped credential belonging to the original Harbor. The
receipt remains readable after the action or rollout feature is disabled. A
credential from another Harbor cannot inspect it. The response does not contain
lookup values, input values, output payloads, credential secrets, or raw provider
errors. It includes structured operation identity, lookup field names, submitted
field names, and the original credential ID.

An overdue executing receipt transitions atomically to `unknown`; this read
never invokes the destination provider. Stop polling at `succeeded`, `failed`, or `unknown`.
Unknown is terminal for this execution identifier and means the update may have
happened. Investigate rather than preparing a replacement action to retry.

Preparation alone has no execution receipt. A `404 Not Found` after an uncertain
execution does not prove the operation never happened.

Send a new nonzero UUID in `X-Polytomic-Activity-Request-ID`. Direct REST requests
may omit `X-Polytomic-Harbor-Session`; a supplied session must be active and bound
to the same credential and Harbor.

## Path parameters

- `harbor_id` string, uuid, required: Unique identifier of the Harbor
- `execution_id` string, uuid, required: Action execution ID

## Headers

- `X-Polytomic-Version` string
- `X-Polytomic-Harbor-Session` string: Harbor session token; when supplied, the session must be active and bound to this credential and Harbor.
- `X-Polytomic-Activity-Request-ID` string: New nonzero UUID for each request, required for scoped credentials; a reused value is rejected.

## Response `200`

OK

- HarborActionExecutionEnvelope
  - `data` HarborActionExecutionResponse
    - `connection_id` string, uuid: Connection ID of the action
    - `credential_id` string, uuid: Original credential attribution, including when another credential submits a duplicate
    - `deadline_at` string, date-time: When an unfinished execution becomes unknown
    - `execution_id` string, uuid: Action execution ID
    - `failure_category` string: Category of a failed or unknown outcome
    - `field_ids` string[], nullable: Submitted field names only, never their values
    - `finished_at` string, date-time, nullable: When the execution reached its final status
    - `lookup_field_id` string: Lookup field ID used to find the target record
    - `operation_id` string: Operation ID of the action
    - `recovery_required` boolean: True when receipt persistence was interrupted or uncertain. Inspect status; this response does not confirm durable acceptance or completion.
    - `schema_id` string: Schema ID of the action
    - `started_at` string, date-time: When the execution started
    - `status` 'executing' | 'succeeded' | 'failed' | 'unknown': Current execution status
    - `status_path` string: API path for reading this execution receipt

## Changes

- **2026-10-22** `d80b0fdea14e`: 1 breaking, 14 warning, 1 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/connection_id` from the response with the `200` status
  - removed the optional property `data/credential_id` from the response with the `200` status
  - removed the optional property `data/deadline_at` from the response with the `200` status
  - …12 more
- **2026-09-21** `9c3de87fb285`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbors/:harbor_id/action-executions/:execution_id/get.md)

---

[API](https://skmtc.dev/polytomic/apis/polytomic-api.md) - [All operations](https://skmtc.dev/polytomic/apis/polytomic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/polytomic/apis/polytomic-api/revisions/3c88180d2470?raw)