--- title: "S3_Import: Update job" method: PUT path: "/job/s3-import/{id}" tags: ["Jobs"] --- # S3_Import: Update job `PUT /job/s3-import/{id}` ## Request - Base URL: `https://api.lytics.io/v2` - URL: `https://api.lytics.io/v2/job/s3-import/{id}` - Auth: API key in header `Authorization` Update a S3_Import 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 - `bucket` string: Select or enter the bucket that you would like to import from - `continuous_update` boolean: Continuously run this import. Import runs daily by default - `delimiter` string: Input the delimiter of the file. Default delimiter is ",". Other common delimiters may be "|" (pipe) or ";". For tab delimited files enter "t" - `diff` boolean: On continuous imports, compare file contents to the previous file contents and import only rows that have changed. This is useful when only full data dumps are provided - `fields` string[]: Select fields to import. Leave empty to import all fields. If no field names appear, the delimiter may need to be adjusted. Also check to ensure the CSV file has an appropriate header row - `file_frequency` string: Choose how often a continuous import should expect a new file - `filename` string: Select or enter the file to import. Listing files may take up to a couple minutes after the bucket is chosen - `folder` string: Select or enter the directory that you would like to import from. This can be slow on large S3 buckets - `prefix` string: Enter the file name prefix. You may use regular expressions - `stream` string: Data stream name - `time_of_day` string: Time of day to start import - `timestamp_field` string: Select the name of the column in the CSV that contains the timestamp of an event. If no field is specified, the event will be timestamped with the time of the import - `timezone` string: Timezone for time of day - `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` S3_Import 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 - `bucket` string: Select or enter the bucket that you would like to import from - `continuous_update` boolean: Continuously run this import. Import runs daily by default - `delimiter` string: Input the delimiter of the file. Default delimiter is ",". Other common delimiters may be "|" (pipe) or ";". For tab delimited files enter "t" - `diff` boolean: On continuous imports, compare file contents to the previous file contents and import only rows that have changed. This is useful when only full data dumps are provided - `fields` string[]: Select fields to import. Leave empty to import all fields. If no field names appear, the delimiter may need to be adjusted. Also check to ensure the CSV file has an appropriate header row - `file_frequency` string: Choose how often a continuous import should expect a new file - `filename` string: Select or enter the file to import. Listing files may take up to a couple minutes after the bucket is chosen - `folder` string: Select or enter the directory that you would like to import from. This can be slow on large S3 buckets - `prefix` string: Enter the file name prefix. You may use regular expressions - `stream` string: Data stream name - `time_of_day` string: Time of day to start import - `timestamp_field` string: Select the name of the column in the CSV that contains the timestamp of an event. If no field is specified, the event will be timestamped with the time of the import - `timezone` string: Timezone for time of day - `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/s3-import/: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)