Is AI recommending you? Ask Contentstack Canoe for free
Is AI recommending your brand? Find out with Contentstack Canoe for free
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Contentstack for Developers
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • The Forrester Wave™: Digital Experience Platforms, Q4 2025
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Lytics API
  4. Jobs
  5. S3 User Csv Export

S3 User Csv Export

markdownView as Markdown

Create and manage data import and export jobs.

S3_UserCsvExport: Create job

POSThttps://api.lytics.io/v2/job/s3-user-csv-export

Create a S3_UserCsvExport job

Sample Request
123456789101112131415161718192021222324252627282930313233343536373839
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "append_hashed_by_fields": true,
    "append_segment_name": true,
    "bucket": "string",
    "compress": "string",
    "continuous_update": true,
    "day_of_week": "string",
    "delimiter": "string",
    "directory": "string",
    "email_me": true,
    "export_segments": true,
    "fields": [
      "string"
    ],
    "filename": "string",
    "filetype": "string",
    "hash_pii_fields": true,
    "region": "string",
    "run_frequency": "string",
    "segment_id": "string",
    "size_limit": 0,
    "time_format": "string",
    "time_of_day": "string",
    "timezone": "string",
    "write_headers": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|201 Created
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "append_hashed_by_fields": true,
      "append_segment_name": true,
      "bucket": "string",
      "compress": "string",
      "continuous_update": true,
      "day_of_week": "string",
      "delimiter": "string",
      "directory": "string",
      "email_me": true,
      "export_segments": true,
      "fields": [
        "string"
      ],
      "filename": "string",
      "filetype": "string",
      "hash_pii_fields": true,
      "region": "string",
      "run_frequency": "string",
      "segment_id": "string",
      "size_limit": 0,
      "time_format": "string",
      "time_of_day": "string",
      "timezone": "string",
      "write_headers": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

S3_UserCsvExport: Get job

GEThttps://api.lytics.io/v2/job/s3-user-csv-export/{id}

Get the summary of a S3_UserCsvExport job

Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "append_hashed_by_fields": true,
      "append_segment_name": true,
      "bucket": "string",
      "compress": "string",
      "continuous_update": true,
      "day_of_week": "string",
      "delimiter": "string",
      "directory": "string",
      "email_me": true,
      "export_segments": true,
      "fields": [
        "string"
      ],
      "filename": "string",
      "filetype": "string",
      "hash_pii_fields": true,
      "region": "string",
      "run_frequency": "string",
      "segment_id": "string",
      "size_limit": 0,
      "time_format": "string",
      "time_of_day": "string",
      "timezone": "string",
      "write_headers": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}

S3_UserCsvExport: Update job

PUThttps://api.lytics.io/v2/job/s3-user-csv-export/{id}

Update a S3_UserCsvExport job

Sample Request
123456789101112131415161718192021222324252627282930313233343536373839
{
  "auth_ids": [
    "string"
  ],
  "config": {
    "append_hashed_by_fields": true,
    "append_segment_name": true,
    "bucket": "string",
    "compress": "string",
    "continuous_update": true,
    "day_of_week": "string",
    "delimiter": "string",
    "directory": "string",
    "email_me": true,
    "export_segments": true,
    "fields": [
      "string"
    ],
    "filename": "string",
    "filetype": "string",
    "hash_pii_fields": true,
    "region": "string",
    "run_frequency": "string",
    "segment_id": "string",
    "size_limit": 0,
    "time_format": "string",
    "time_of_day": "string",
    "timezone": "string",
    "write_headers": true
  },
  "description": "string",
  "drop_events_during_quiet_window": true,
  "expires_at": "2019-08-24T14:15:22Z",
  "monitoring": {},
  "name": "string",
  "quiet_period": 0,
  "quiet_time_of_day": "string",
  "quiet_timezone": "string"
}
Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "anomaly_rule": {
      "aid": 0,
      "checks": [
        {
          "allowable_violations": 0,
          "interval": "string",
          "lookback_count": 0,
          "max_threshold": 0,
          "metric_type": "string",
          "min_threshold": 0,
          "type": "string",
          "variance_pct": 0
        }
      ],
      "created": "string",
      "id": "string",
      "subject_id": "string",
      "subject_type": "string",
      "updated": "string"
    },
    "api_token_auth_id": "string",
    "auth_ids": [
      "string"
    ],
    "config": {
      "append_hashed_by_fields": true,
      "append_segment_name": true,
      "bucket": "string",
      "compress": "string",
      "continuous_update": true,
      "day_of_week": "string",
      "delimiter": "string",
      "directory": "string",
      "email_me": true,
      "export_segments": true,
      "fields": [
        "string"
      ],
      "filename": "string",
      "filetype": "string",
      "hash_pii_fields": true,
      "region": "string",
      "run_frequency": "string",
      "segment_id": "string",
      "size_limit": 0,
      "time_format": "string",
      "time_of_day": "string",
      "timezone": "string",
      "write_headers": true
    },
    "created": "string",
    "deleted": true,
    "description": "string",
    "drop_events_during_quiet_window": true,
    "expires_at": "2019-08-24T14:15:22Z",
    "id": "string",
    "meta": {},
    "monitoring": {},
    "name": "string",
    "quiet_period": 0,
    "quiet_time_of_day": "string",
    "quiet_timezone": "string",
    "sleep_until": "string",
    "status": "runnable",
    "updated": "string",
    "user_id": "string",
    "workflow": "string",
    "workflow_id": "string"
  },
  "request_id": "string",
  "status": 0
}
Hide Parameters

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.append_hashed_by_fieldsoptionalboolean

Select to add a column containing a hash of user BY fields

config.append_segment_nameoptionalboolean

Select to add a column with the name of the exported Lytics audience

config.bucketoptionalstring

Select or enter the bucket that you would like to save your files in

config.compressoptionalstring

Compress file

config.continuous_updateoptionalboolean

Select to run this export continuously

config.day_of_weekoptionalstring

Day of week to run work

config.delimiteroptionalstring

Designate a custom delimiter for your file. Default delimiter is ",". A recommended custom delimiter is "|" (pipe).

config.directoryoptionalstring

Select or enter the directory that you would like to save your files in. The directory suggestions can be slow on large S3 buckets

config.email_meoptionalboolean

Whether to send export link

config.export_segmentsoptionalboolean

Select to add a column containing all the Lytics audiences a user is a member of

config.fieldsoptionalstring[]

Select user fields to export. If none are selected all user fields will be included

config.filenamerequiredstring

Filename of upload.

config.filetypeoptionalstring

Select CSV, Multi-file CSV, or JSON formatted files. For Multi-file CSVs, non-scalar fields will be exported in separate CSVs and can be tied together through a join key

config.hash_pii_fieldsoptionalboolean

Select to SHA256-hash the account's PII/private fields (e.g. email, phone) in the exported file. Non-PII fields are unchanged. Off by default.

config.regionoptionalstring

AWS region that S3 resides in (us-east-2, etc.)

config.run_frequencyoptionalstring

Choose how often a continuous export should export a new file. Default is daily

config.segment_idoptionalstring

The name of the audience that contains the users to export

config.size_limitoptionalinteger

Optional, set maximum number of users to include in the export. If set, the users exported will be a random selection of users"

config.time_formatoptionalstring

The format for the timestamp at the end of the filename

config.time_of_dayoptionalstring
config.timezoneoptionalstring
config.write_headersoptionalboolean

Select to include the field names as the first row of the exported file

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring
Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The Job ID

Query Parameters

account_idoptionalstring

The account ID. Defaults to the user's default account.

Headers

Authorizationoptionalstring

Body Parameters

auth_idsoptionalstring[]

Authorization IDs associated with the Job

configrequiredobject

Job configuration, unique per-workflow

config.append_hashed_by_fieldsoptionalboolean

Select to add a column containing a hash of user BY fields

config.append_segment_nameoptionalboolean

Select to add a column with the name of the exported Lytics audience

config.bucketoptionalstring

Select or enter the bucket that you would like to save your files in

config.compressoptionalstring

Compress file

config.continuous_updateoptionalboolean

Select to run this export continuously

config.day_of_weekoptionalstring

Day of week to run work

config.delimiteroptionalstring

Designate a custom delimiter for your file. Default delimiter is ",". A recommended custom delimiter is "|" (pipe).

config.directoryoptionalstring

Select or enter the directory that you would like to save your files in. The directory suggestions can be slow on large S3 buckets

config.email_meoptionalboolean

Whether to send export link

config.export_segmentsoptionalboolean

Select to add a column containing all the Lytics audiences a user is a member of

config.fieldsoptionalstring[]

Select user fields to export. If none are selected all user fields will be included

config.filenamerequiredstring

Filename of upload.

config.filetypeoptionalstring

Select CSV, Multi-file CSV, or JSON formatted files. For Multi-file CSVs, non-scalar fields will be exported in separate CSVs and can be tied together through a join key

config.hash_pii_fieldsoptionalboolean

Select to SHA256-hash the account's PII/private fields (e.g. email, phone) in the exported file. Non-PII fields are unchanged. Off by default.

config.regionoptionalstring

AWS region that S3 resides in (us-east-2, etc.)

config.run_frequencyoptionalstring

Choose how often a continuous export should export a new file. Default is daily

config.segment_idoptionalstring

The name of the audience that contains the users to export

config.size_limitoptionalinteger

Optional, set maximum number of users to include in the export. If set, the users exported will be a random selection of users"

config.time_formatoptionalstring

The format for the timestamp at the end of the filename

config.time_of_dayoptionalstring
config.timezoneoptionalstring
config.write_headersoptionalboolean

Select to include the field names as the first row of the exported file

descriptionoptionalstring

A user-defined description

drop_events_during_quiet_windowoptionalboolean
expires_atoptionalstring (date-time)
monitoringoptionalobject

Inline monitoring config. On write: omit to keep, null to clear, or a config to set.

namerequiredstring

A user-defined name

quiet_periodoptionalinteger
quiet_time_of_dayoptionalstring
quiet_timezoneoptionalstring