---
title: "Model Sync Field Query"
method: GET
path: "/api/connections/{id}/modelsync/source/fields"
tags: ["Model Sync"]
---

# Model Sync Field Query

`GET /api/connections/{id}/modelsync/source/fields`

Returns the source fields available on a connection for a given source configuration.

Pass the model's source configuration as query parameters to resolve the
fields that the connection will expose for that specific configuration. The
returned fields are what can be referenced in sync field mappings.

> 📘 Results depend on the source configuration you supply. A different
> table or query in the configuration may return a completely different field
> list.

The available source configuration parameters are described by
[`GET /api/connections/{id}/modelsync/source`](../../../../../../api-reference/model-sync/get-source).

## Path parameters

- `id` string, uuid, required — Unique identifier of the connection.

## Query parameters

- `params` object — Source configuration, matching the params used with GET /api/connections/{id}/modelsync/source, that selects the specific source to return fields for.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- ModelFieldResponse
  - `data` ModelField[], nullable
    - `created_at` string, date-time
    - `created_by` OutputActor
      - `id` string, uuid
      - `name` string
      - `type` string
    - `description` string
    - `example` unknown
    - `id` string, uuid
    - `label` string
    - `name` string
    - `remote_type` string
    - `type` string
    - `unique` boolean
    - `updated_at` string, date-time
    - `user_added` boolean

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/b509e00e80aa/schema)
