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

# Get Harbor Action Configuration

`GET /api/harbors/{harbor_id}/action-configuration`

## Request

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

Returns configured action grants and revisions for a Harbor.

You must be an Organization administrator with permission to edit the Harbor.
Use a writable API credential, not a Harbor profile credential. Read-only keys
are denied because this endpoint requires Harbor edit permission.

This response includes grants for Connections that no longer populate the
Harbor. You can remove those stale grants without reattaching the Connection.
Reading configuration does not require the Harbor Actions entitlement.

Use each Connection's `revision` as `expected_revision` when replacing or
removing its grants. Configuration responses contain metadata only, not provider
credentials or record values.

## Path parameters

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

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- HarborActionConfigurationEnvelope
  - `data` HarborActionConfigurationResponse[], nullable: All configured action Connections after this request
    - `connection_id` string, uuid: Configured source Connection ID, including sources no longer attached to the Harbor
    - `created_at` string, date-time: When these grants were first created
    - `grants` HarborActionGrantSchema[], nullable: Configured action permissions
      - `field_ids` string[], nullable, required: Unique input field IDs for a mutating operation, or output field IDs for a read-only operation
      - `lookup_field_ids` string[]: Unique lookup field IDs for a read-only operation. Omit for a mutating operation.
      - `operation_id` string, required: Exact operation ID from operation discovery
      - `schema_id` string, required: Exact action schema ID
    - `revision` string, uuid: Revision to supply when replacing or removing these grants
    - `updated_at` string, date-time: When these grants were last replaced

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-15** `2d18f9f86996`: 1 info
  - endpoint added

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