---
title: "Get Harbor Connection Schema"
method: GET
path: "/api/harbor/connections/{connection_id}/schemas/{schema_id}"
tags: ["Harbor Discovery"]
---

# Get Harbor Connection Schema

`GET /api/harbor/connections/{connection_id}/schemas/{schema_id}`

## Request

- Base URL: `https://app.polytomic.com`
- URL: `https://app.polytomic.com/api/harbor/connections/{connection_id}/schemas/{schema_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Returns one schema resource authorized by the current Harbor profile.

## Path parameters

- `connection_id` string, uuid, required: Connection ID
- `schema_id` string, required: Schema 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

- HarborConnectionSchemaEnvelope
  - `data` Schema
    - `fields` SchemaField[]: Fields in the schema
      - `association` SchemaAssociation
        - `id` string: Association ID
        - `name` string: Association name
        - `reference_to` string[]: Schema IDs the field references
        - `referenced_field` string: Field in the referenced schema that the field matches
      - `id` string: Schema field ID
      - `is_primary_key` boolean: Whether this field is part of the schema's primary key, including any user override
      - `name` string: Display name of the field
      - `path` string: JSONPath used to extract the field from each source record; only meaningful for document-style backends
      - `primary_key_override` boolean, nullable: The user-set primary key status for this field, which takes precedence over source_primary_key; omitted when no override is set
      - `remote_type` string: The type of the field from the remote system
      - `source_primary_key` boolean: Whether the source system reports this field as part of the schema's primary key
      - `type` 'unknown' | 'string' | 'number' | 'boolean' | 'datetime' | 'array' | 'object' | 'binary'
      - `type_spec` unknown
      - `user_managed` boolean: True when the field's effective definition came from a user override
      - `values` PickValue[]: Allowed values for the field
        - `depends_on` object: Field IDs and internal values required for this option to apply. All entries must match. Omitted for independent options.
        - `label` string: Display label of the option
        - `value` string: Value of the option
    - `id` string: Schema ID
    - `name` string: Display name of the schema

## Changes

- **2026-10-22** `d80b0fdea14e`: 1 breaking, 3 warning, 1 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/fields` from the response with the `200` status
  - removed the optional property `data/id` from the response with the `200` status
  - removed the optional property `data/name` from the response with the `200` status
  - …1 more
- **2026-10-21** `61c2b96f65ba`: 2 breaking, 4 warning, 11 info
  - the `data/fields/items/association` response's property type changed from `object` to no type for status `200`
  - the `data/fields/items/type` response's property type changed from `string` to no type for status `200`
  - removed the optional property `data/fields/items/association/id` from the response with the `200` status
  - removed the optional property `data/fields/items/association/name` from the response with the `200` status
  - …13 more
- **2026-10-01** `764e19e89365`: 1 info
  - added the optional property `data/fields/items/values/items/depends_on` to the response with the `200` status
- **2026-09-10** `f2fa886a0742`: 2 info
  - added the optional property `data/fields/items/primary_key_override` to the response with the `200` status
  - added the optional property `data/fields/items/source_primary_key` to the response with the `200` status
- **2026-09-05** `30ade6c6d535`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polytomic/apis/polytomic-api/changes/api/harbor/connections/:connection_id/schemas/:schema_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)