Model Sync Field Query | Polytomic Docs

curl -G https://app.polytomic.com/api/connections/248df4b7-aa70-47b8-a036-33ac447e668d/modelsync/source/fields \
     -H "X-Polytomic-Version: 2025-09-18" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d "params[table]=customers" \
     -d "params[schema]=public"

{
  "data": [
    {
      "created_at": "2024-01-15T09:30:00Z",
      "created_by": {
        "id": "12345678-1234-1234-1234-123456789012",
        "name": "John Doe",
        "type": "user"
      },
      "description": "Unique identifier",
      "example": 101,
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "label": "ID",
      "name": "id",
      "remote_type": "uuid",
      "type": "string",
      "unique": true,
      "updated_at": "2024-01-15T09:30:00Z",
      "user_added": false
    },
    {
      "created_at": "2024-01-15T09:35:00Z",
      "created_by": {
        "id": "87654321-4321-4321-4321-210987654321",
        "name": "Jane Smith",
        "type": "user"
      },
      "description": "Customer's full name",
      "example": "Alice Johnson",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "label": "Full Name",
      "name": "full_name",
      "remote_type": "varchar",
      "type": "string",
      "unique": false,
      "updated_at": "2024-01-15T09:35:00Z",
      "user_added": false
    },
    {
      "created_at": "2024-01-15T09:40:00Z",
      "created_by": {
        "id": "12345678-1234-1234-1234-123456789012",
        "name": "John Doe",
        "type": "user"
      },
      "description": "Customer's email address",
      "example": "alice.johnson@example.com",
      "id": "b2c3d4e5-f678-90ab-cdef-1234567890ab",
      "label": "Email",
      "name": "email",
      "remote_type": "varchar",
      "type": "string",
      "unique": true,
      "updated_at": "2024-01-15T09:40:00Z",
      "user_added": false
    },
    {
      "created_at": "2024-01-15T09:45:00Z",
      "created_by": {
        "id": "87654321-4321-4321-4321-210987654321",
        "name": "Jane Smith",
        "type": "user"
      },
      "description": "Date the customer was created",
      "example": "2023-11-01T12:00:00Z",
      "id": "c3d4e5f6-7890-abcd-ef12-34567890abcd",
      "label": "Created At",
      "name": "created_at",
      "remote_type": "timestamp",
      "type": "string",
      "unique": false,
      "updated_at": "2024-01-15T09:45:00Z",
      "user_added": false
    }
  ]
}

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.

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).

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"

Unique identifier of the connection.

Query parameters

paramsmap from strings to lists of stringsOptional

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

Response

datalist of objects or null

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors