---
title: "List Harbor Actions"
method: GET
path: "/api/harbors/{harbor_id}/actions"
tags: ["Harbors"]
---

# List Harbor Actions

`GET /api/harbors/{harbor_id}/actions`

## Request

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

List a page of configured action identities without loading provider capabilities or field metadata.

Use a scoped credential belonging to this Harbor. An administrator must first
select Connections and explicitly enable object operations and fields. These
grants apply to existing and future eligible Harbor credentials without changing
read access. Newly available objects and fields remain disabled until selected.

Each entry identifies a configured operation by `connection_id`, `schema_id`, and
`operation_id`. Search filters those identities. Follow
`pagination.next_page_token` with the same search to read additional pages.
Pages contain saved identities without field metadata or provider capability
checks. `unavailable: true` means the saved Connection is unavailable for actions;
its permissions remain saved and revocable. An available Connection does not
confirm that its operations or granted fields are currently available.

Use [Describe action](../../../../api-reference/harbors/actions/describe) for the selected
operation before looking up a record or
[preparing an action](../../../../api-reference/harbors/actions/prepare). Description checks
current provider capabilities and returns the operation's `effect` (`read_only`
or `mutating`) and effective granted fields.
Always submit the intended Connection explicitly when looking up or preparing,
even if only one is enabled. If several destinations match your intent, clarify
which one to use.

Read-only operations use [Lookup action](../../../../api-reference/harbors/actions/lookup)
without preparation or approval. Salesforce and HubSpot support exact lookups by
their canonical record ID. Listing does not grant additional permissions or
authorize mutations by a read-only credential.

Send a new nonzero UUID in `X-Polytomic-Activity-Request-ID`. For direct REST
requests, `X-Polytomic-Harbor-Session` is optional. If supplied, the session must
be active and bound to the credential and Harbor. Discovery is recorded as
`action.listed`; no response is returned if that event cannot be recorded.

## Path parameters

- `harbor_id` string, uuid, required: Unique identifier of the Harbor

## Query parameters

- `search` string: Filter configured schema or operation identities.
- `page_token` string: Continuation token from the previous page; keep search unchanged.
- `limit` integer: Maximum number of actions to return

## 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

- HarborActionListEnvelope
  - `data` HarborActionSummary[], nullable: Configured actions on this page
    - `connection_id` string, uuid: Connection ID
    - `connection_name` string: Name of the connection; empty when unavailable is true
    - `operation_id` string: Operation ID
    - `schema_id` string: Schema ID
    - `unavailable` boolean: Whether the connection cannot currently run actions; schema and operation availability is checked when the action is described
  - `pagination` object: Pagination details for the next page
    - `next_page_token` string: Token for the next page

## Changes

- **2026-09-21** `9c3de87fb285`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbors/:harbor_id/actions/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)