---
title: "SnapchatCapiExport: Update job"
method: PUT
path: "/job/snapchat-capi-export/{id}"
tags: ["Jobs"]
---

# SnapchatCapiExport: Update job

`PUT /job/snapchat-capi-export/{id}`

## Request

- Base URL: `https://api.lytics.io/v2`
- URL: `https://api.lytics.io/v2/job/snapchat-capi-export/{id}`
- Auth: API key in header `Authorization`

Update a SnapchatCapiExport job

## Path parameters

- `id` string, required

## Query parameters

- `account_id` string

## Request body `*/*`

- object
  - `auth_ids` string[]: Authorization IDs associated with the Job
  - `config` object, required: Job configuration, unique per-workflow
    - `action_source` 'WEB' | 'OFFLINE' | 'MOBILE_APP': Select the action source describing where the conversion occurred. Required by Snapchat; defaults to OFFLINE.
    - `audience_events` 'enters_only' | 'exits_only': Select which audience trigger events to send. By default both enters and exits are sent.
    - `conversion_id` string: Optional. Select the Lytics user field containing a unique conversion/event ID used for deduplication.
    - `currency_code` string: Optional. Select the Lytics user field containing the ISO currency code for the conversion value.
    - `event_name` string, required: Select the Snapchat event to send. Map a custom conversion in Snapchat Ads Manager to a CUSTOM_EVENT_N slot to send your own event.
    - `event_source_url_field` string: Optional. Select the Lytics user field containing the URL where the event occurred.
    - `event_timestamp` string: Select the Lytics user field containing the event time. Defaults to the processing time when not set. Events more than 7 days old are dropped.
    - `field_changes` string[]: Select up to 75 user fields. If any selected field changes for a user in the exported audience, a conversion event will be sent.
    - `item_count` string: Optional. Select the Lytics user field containing the number of items in the conversion.
    - `pixel_id` string, required: Enter your Snap Pixel ID (WEB/OFFLINE events) or Snap App ID (MOBILE_APP events) from Snapchat Ads Manager.
    - `segment_ids` string[], required: Select the Lytics audiences that contain the users to export
    - `user_data_mapping` object[], required: Map Lytics user fields to Snapchat user_data identifiers. At least one identifier is required.
    - `value` string: Optional. Select the Lytics user field containing the monetary value of the conversion.
    - `withbackfill` boolean: Select to immediately push users who currently exist in the selected Lytics audience. Deselecting will only send conversions as users enter or exit the audience.
  - `description` string: A user-defined description
  - `drop_events_during_quiet_window` boolean
  - `expires_at` string, date-time
  - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
  - `name` string, required: A user-defined name
  - `quiet_period` integer
  - `quiet_time_of_day` string
  - `quiet_timezone` string

## Response `200`

SnapchatCapiExport Job

- object
  - `_meta` object: Response Metadata
  - `data` object: Response Payload
    - `account_id` string: Lytics Account ID
    - `anomaly_rule` ModelsAnomalyRuleResp
      - `aid` integer
      - `checks` ModelsRuleCheckConfigReq[]
        - `allowable_violations` integer
        - `interval` string
        - `lookback_count` integer
        - `max_threshold` integer
        - `metric_type` string
        - `min_threshold` integer
        - `type` string
        - `variance_pct` number
      - `created` string
      - `id` string
      - `subject_id` string
      - `subject_type` string
      - `updated` string
    - `api_token_auth_id` string: this is set when work is create using access token
    - `auth_ids` string[]: Authorization IDs associated with the Job
    - `config` object, required: Job configuration, unique per-workflow
      - `action_source` 'WEB' | 'OFFLINE' | 'MOBILE_APP': Select the action source describing where the conversion occurred. Required by Snapchat; defaults to OFFLINE.
      - `audience_events` 'enters_only' | 'exits_only': Select which audience trigger events to send. By default both enters and exits are sent.
      - `conversion_id` string: Optional. Select the Lytics user field containing a unique conversion/event ID used for deduplication.
      - `currency_code` string: Optional. Select the Lytics user field containing the ISO currency code for the conversion value.
      - `event_name` string, required: Select the Snapchat event to send. Map a custom conversion in Snapchat Ads Manager to a CUSTOM_EVENT_N slot to send your own event.
      - `event_source_url_field` string: Optional. Select the Lytics user field containing the URL where the event occurred.
      - `event_timestamp` string: Select the Lytics user field containing the event time. Defaults to the processing time when not set. Events more than 7 days old are dropped.
      - `field_changes` string[]: Select up to 75 user fields. If any selected field changes for a user in the exported audience, a conversion event will be sent.
      - `item_count` string: Optional. Select the Lytics user field containing the number of items in the conversion.
      - `pixel_id` string, required: Enter your Snap Pixel ID (WEB/OFFLINE events) or Snap App ID (MOBILE_APP events) from Snapchat Ads Manager.
      - `segment_ids` string[], required: Select the Lytics audiences that contain the users to export
      - `user_data_mapping` object[], required: Map Lytics user fields to Snapchat user_data identifiers. At least one identifier is required.
      - `value` string: Optional. Select the Lytics user field containing the monetary value of the conversion.
      - `withbackfill` boolean: Select to immediately push users who currently exist in the selected Lytics audience. Deselecting will only send conversions as users enter or exit the audience.
    - `created` string
    - `deleted` boolean: The Job has been deleted
    - `description` string: A user-defined description
    - `drop_events_during_quiet_window` boolean
    - `expires_at` string, date-time
    - `id` string: A Lytics-assigned, immutable unique ID for the Job
    - `meta` object: Extra meta data about the job
    - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
    - `name` string, required: A user-defined name
    - `quiet_period` integer
    - `quiet_time_of_day` string
    - `quiet_timezone` string
    - `sleep_until` string
    - `status` 'runnable' | 'sleeping' | 'paused' | 'completed' | 'fault' | 'failed' | 'killed' | 'deleted' | 'unknown': The status of the job
    - `updated` string
    - `user_id` string: The user ID that created or updated the job
    - `workflow` string: The workflow slug
    - `workflow_id` string: The workflow ID
  - `request_id` string
  - `status` integer: HTTP Status Code

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `d8e975057aec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lytics/apis/lytics-api/changes/job/snapchat-capi-export/:id/put.md)

---

[API](https://skmtc.dev/lytics/apis/lytics-api.md) - [All operations](https://skmtc.dev/lytics/apis/lytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lytics/apis/lytics-api/revisions/d8e975057aec?raw)