---
title: "Sync Clay Table Rows"
method: POST
path: "/api/destinations/clay/targets/{target_id}/sync"
tags: ["destinations"]
---

# Sync Clay Table Rows

`POST /api/destinations/clay/targets/{target_id}/sync`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/destinations/clay/targets/{target_id}/sync`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Path parameters

- `target_id` string, required

## Request body

- ClayTableSyncRequest
  - `idempotency_key` string, required: Stable exact-replay identity for this row chunk.
  - `rows` object[], required: Complete caller-owned row projections, including every target identity field.

## Response `200`

Successful Response

- ClayTableSyncResult
  - `counts` ClayTableOutcomeCounts, required: Sparse row outcome counts. An absent status means zero rows with that outcome.
    - `delivered` integer: Rows whose changed content was delivered.
    - `failed` integer: Rows whose delivery failed with a known outcome.
    - `unchanged` integer: Rows already current, requiring no delivery.
    - `unknown` integer: Rows whose delivery outcome needs reconciliation.
  - `idempotency_key` string, required: Caller-supplied request identity.
  - `replayed` boolean, required: Whether this response was adopted from durable state.
  - `request_id` string, required: Durable request identity used for exact replay.
  - `rows` ClayTableRowSyncResult[], required: Input-ordered durable outcome for every requested row.
    - `error_code` string, nullable, required: Bounded failure category, if any.
    - `generation` integer, required: Monotonic payload generation for this identity.
    - `identity_key` string, required: Canonical platform key for the business identity.
    - `operation_id` string, nullable, required: Durable provider operation, when dispatched.
    - `status` 'delivered' | 'unchanged' | 'failed' | 'unknown', required: Terminal row projection outcome.
  - `target_id` string, required: Clay target receiving these rows.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)