Update Sync Job Template

Updates an existing sync job template by its ID. The template must belong to the user’s team.

Endpoint

http

PATCH /sync-job-template/{id}

Path parameters

string · uuid

REQUIRED ·

The ID of the sync job template to update.

Request Body

integration_name

string

If you want to change the integration for the template.

args_schema

object

JSON schema defining the structure of the arguments that can be passed to the sync job.

Example:

{
  "type": "object",
  "properties": {
    "project_slug": {
      "type": "string",
      "description": "The project slug of the project on CircleCI. Its in the format vcs_provider/org_name/repo_name.",
      "required": true
    }
  }
}

resources

object[]

resource

string

REQUIRED ·

The name of the resource to sync. For Unified APIs, it should be in the format unified_api_name/resource_name. For Proxy API, it can just be resource_name.

Example: For fetching Contacts from CRM Unified API, `crm/contacts`. For fetching Contacts from a Proxy API, `contacts`.

method

string

REQUIRED ·

The method to call on the resource.

Example: list

string

The ID of the resource to sync. This is optional and can be used to sync a single resource. It also supports placeholders.

Example: Static value like `4a4de828-f4db-4c9e-adfd-434e0864c3c7` or placeholder like `{{args.user_id}}`.

query

object

The query parameters to pass to the resource method. It supports placeholders for values.

Example:

{
  "page": 1,
  "per_page": 100,
  "user_id": "{{args.user_id}}"
}

loop_on

string

When a particular placeholder argument is an array and you want to repeat the request for each element in that array, you can set this parameter. For example, if you accept an argument called user_ids which is an array of strings, and you want to fetch each user's details, you can set this parameter to user_ids and the request will be repeated for each element in the user_ids array.

Example:

{
  "{ args.user_ids }": null
}

depends_on

string

The resource that this resource depends on (parent resource). This is optional and can be used to sync a resource only after another resource has been synced. Each object synced for the parent resource is available as the resources object in placeholders for the child resource, e.g. {{resources.crm.contacts.id}} if depends on is crm/contacts resource.

Example: crm/contacts

persist

boolean

Whether to persist the resource in the database or not in case of a Daemon sync job run or send as a payload in case of RapidBridge sync job run. The Proxy API resources are by default NOT persisted and this parameter can be set to true to persist them. Unified API resources are always persisted.

updated_at

string · date-time

Timestamp automatically updated.

default_runtime_version

number

The default runtime version for sync jobs using this template.

label

string

A short descriptor for the template.

description

string

Optional longer description of what this template does.

Example: Fetches contacts from Zendesk

sharing

string

All possible enum values:

allow
ask
deny

Response Body

string · uuid

The unique ID of the sync job template.

integration_name

string

The integration name to which this template applies.

Example: zendesk

label

string

A short descriptor for the template.

Example: Zendesk contacts sync

description

string

Optional longer description of what this template does.

Example: Fetches contacts from Zendesk

args_schema

object

Optional JSON schema describing arguments for the sync job.

Example:

{
  "type": "object",
  "properties": {
    "project_slug": {
      "type": "string",
      "description": "The project slug of the project on CircleCI. Its in the format vcs_provider/org_name/repo_name.",
      "required": true
    }
  }
}

resources

object[]

A list of sync job resources that define the steps. If empty, no default resources are set.

resource

string

REQUIRED ·

The name of the resource to sync. For Unified APIs, it should be in the format unified_api_name/resource_name. For Proxy API, it can just be resource_name.

Example: For fetching Contacts from CRM Unified API, `crm/contacts`. For fetching Contacts from a Proxy API, `contacts`.

method

string

REQUIRED ·

The method to call on the resource.

Example: list

string

The ID of the resource to sync. This is optional and can be used to sync a single resource. It also supports placeholders.

Example: Static value like `4a4de828-f4db-4c9e-adfd-434e0864c3c7` or placeholder like `{{args.user_id}}`.

query

object

The query parameters to pass to the resource method. It supports placeholders for values.

Example:

{
  "page": 1,
  "per_page": 100,
  "user_id": "{{args.user_id}}"
}

loop_on

string

Example:

{
  "{ args.user_ids }": null
}

depends_on

string

Example: crm/contacts

persist

boolean

default_runtime_version

number

The runtime version for any sync job that uses this template.

Example: 2

team_id

string · uuid

The team that owns this template.

Example: 05daecaf-4365-42e8-8370-8127de5dd717

sharing

string

The sharing policy of the template.

All possible enum values:

allow
ask
deny

Example: deny

created_at

string · date-time

When the template was created.

Example: 2024-01-10T10:00:00.000Z

updated_at

string · date-time

When the template was last updated.

Example: 2024-01-11T12:30:00.000Z