---
title: "POST /workspaces/{workspaceId}/sync-jobs/{syncSource}"
method: POST
path: "/workspaces/{workspaceId}/sync-jobs/{syncSource}"
---

# POST /workspaces/{workspaceId}/sync-jobs/{syncSource}

`POST /workspaces/{workspaceId}/sync-jobs/{syncSource}`

This action creates a SyncJob.

## Path parameters

- `workspaceId` string, required
- `syncSource` string, required

## Request body

- object
  - `syncRole` string, required — The SyncJob IAM role. This IAM role is used by the SyncJob to read from the syncSource, and create, update, or delete the corresponding resources.
  - `tags` object — The SyncJob tags.

## Response `200`

Success

- CreateSyncJobResponse
  - `arn` string, required — The SyncJob ARN.
  - `creationDateTime` string, date-time, required — The date and time for the SyncJob creation.
  - `state` 'CREATING' | 'INITIALIZING' | 'ACTIVE' | 'DELETING' | 'ERROR', required — The SyncJob response state.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — ConflictException
- `485` — ServiceQuotaExceededException

---

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