--- title: "DotmailerExport: Update job" method: PUT path: "/job/dotmailer-export/{id}" tags: ["Jobs"] --- # DotmailerExport: Update job `PUT /job/dotmailer-export/{id}` Update a DotmailerExport job ## Path parameters - `id` string, required ## Query parameters - `account_id` string ## Response `200` DotmailerExport 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 - `address_book_name` string — Enter a new address book name to be created in dotdigital. If left blank will default to 'Lytics + audience name' NOTE: this will only be used if the 'Existing Address Book' is left blank - `address_book_status_field` string — Select the Lytics field that contains the user's dotdigital address book status. Leave blank if this is not an acquisition sync export - `audience_name` string — Choose the address book to add contacts to. If you want to create a new address book enter the name in the 'New Address Book Name' field below - `backfill_only` boolean — Select this to do a one time export of the audience - `collection_id` string — Content collection to include recommendations from - if not selected, no recommendations are sent to dotdigital - `disable_dedupe` boolean — Selecting this will disable deduplication of events - `email_field` string — Field that contains the contact's email - `email_type` string — The type of emails these contacts can receive - `exit_action` string — The action to take when an entity exits the audience. Note: Unsubscribing will significantly increase API usage - `field_changes` string[] — Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected fields get an update, then the user will be updated in dotdigital - `id_field` string — Field that contains the contact's dotdigital ID. This may be a map field if importing users from multiple accounts - `insight_fields` string[] — Select the Lytics user fields you would like to send to the lytics_fields insight collection in dotdigital. Insight data supports complex data types like arrays and maps - `insight_recommendations` boolean — Select to add content recommendations for users to the lytics_recommendations insight collection in dotdigital - `mappings` object[] — Map Lytics fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields - `opt_in_type` string — Opt-in type for the contacts that will be created; see [dotdigital documentation](https://support.dotdigital.com/hc/en-gb/articles/212212098-Explaining-contact-opt-in-types) for details - `recommender_mappings` object[] — Map content recommendation fields to dotdigital contact fields by selecting the Lytics field on the left, and its dotdigital destination on the right. NOTE: Complex fields such as arrays and maps are not supported by contact fields - `resubscribe` boolean — Contacts will be resubscribed to address books. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level - `resubscribe_no_challenge` boolean — Contacts will be resubscribed to address books without triggering a confirmation email. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level - `seg_mappings` object[] — Map all Lytics Audiences to dotdigital address books by selecting the Lytics audience on the left, and its dotdigital destination on the right - `segment_id` string — Choose the audience of users to export to dotdigital - `segment_ids` string[] — Which Lytics Audience(s) to export to dotdigital - `sync_status` boolean — Select to update user status in lytics immediately, this will add events to the dotmailer_export_status stream. Note: this can cause feedback loops that can cause poor performance - `trigger_join` boolean — Contacts will trigger join actions when added to the address book. Note: this will significantly increase API usage - `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 --- [API](https://skmtc.net/lytics/apis/lytics-api.md) · [All operations](https://skmtc.net/lytics/apis/lytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lytics/lytics-api/versions/366eeabcb6de/schema)