> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute a typed commerce sync plan using the configured tenant orchestrators.

> Plan execution result

### Path parameters

**tenant\_id** `string` *required*

Tenant identifier

### Request body

`object`

**tenantId** `string` *required*

**salesChannel** `object` *required*

**fulfillmentSystem** `object` *required*

**erpSystem** `object`

**controlPlane** `object`

**includeInventory** `boolean`

Default false

### Response

`object`

**planId** `string` *required*

**tenantId** `string` *required*

**status** `string` *required*

**startedAt** `string (date-time)` *required*

**finishedAt** `string (date-time)` *required*

**totalSteps** `integer` *required*

**succeeded** `integer` *required*

**failed** `integer` *required*

**skipped** `integer` *required*

**planned** `integer` *required*

Steps that ran only in dry-run mode and were not actually executed

**steps** `object[]` *required*

**steps**

**stepId** `string` *required*

**operation** `string` *required*

**from** `string` *required*

**to** `string` *required*

**status** `string` *required*

**startedAt** `string (date-time)` *required*

**finishedAt** `string (date-time)` *required*

**evidence** `object` *required*

**error** `string`

### Status codes

| Code | Meaning |
| - | - |
| `200` | Plan execution result |
| `401` | Unauthorized |
| `422` | Validation error |

```bash cURL theme={null}
curl --request POST \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/sync/plan/execute' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "tenantId": "acme-outdoors",
  "salesChannel": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "label": "Replacement tent pole set",
    "systemKind": "sales_channel",
    "capabilities": [
      "pull_orders"
    ]
  },
  "fulfillmentSystem": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "label": "Replacement tent pole set",
    "systemKind": "sales_channel",
    "capabilities": [
      "pull_orders"
    ]
  },
  "erpSystem": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "label": "Replacement tent pole set",
    "systemKind": "sales_channel",
    "capabilities": [
      "pull_orders"
    ]
  },
  "controlPlane": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "label": "Replacement tent pole set",
    "systemKind": "sales_channel",
    "capabilities": [
      "pull_orders"
    ]
  },
  "includeInventory": true
}'
```

```json 200 theme={null}
{
  "planId": "string",
  "tenantId": "acme-outdoors",
  "status": "planned",
  "startedAt": "2026-08-31T14:22:05Z",
  "finishedAt": "2026-08-31T14:22:05Z",
  "totalSteps": 1,
  "succeeded": 1,
  "failed": 1,
  "skipped": 1,
  "planned": 1,
  "steps": [
    {
      "stepId": "string",
      "operation": "order_ingest",
      "from": "string",
      "to": "string",
      "status": "planned",
      "startedAt": "2026-08-31T14:22:05Z",
      "finishedAt": "2026-08-31T14:22:05Z",
      "evidence": {},
      "error": "string"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.