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. Segments

Segments

markdownView as Markdown

Create and manage audience segments.

Get segments

GEThttps://api.lytics.io/v2/segment

Get a list of segments for an account

Sample Response
Status|200 OK
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
{
  "_meta": {},
  "data": [
    {
      "account_id": "string",
      "aid": 0,
      "ast": {
        "args": [
          {}
        ],
        "ident": "string",
        "op": "string",
        "val": "string"
      },
      "author_id": "string",
      "category": "string",
      "created": "string",
      "datemath_calc": true,
      "deleted": true,
      "description": "string",
      "field_changes_fields": [
        "string"
      ],
      "fields": [
        "string"
      ],
      "forward_datemath": true,
      "groups": [
        "string"
      ],
      "id": "string",
      "identities": [
        "string"
      ],
      "includes": [
        "string"
      ],
      "invalid": true,
      "invalid_reason": "string",
      "is_public": true,
      "kind": "string",
      "name": "string",
      "public_name": "string",
      "ql_resolved": "string",
      "save_hist": true,
      "schedule_exit": true,
      "segment_ql": "string",
      "size": 0,
      "slug_name": "string",
      "table": "string",
      "tags": [
        "string"
      ],
      "updated": "string",
      "withs_ql": "string"
    }
  ],
  "request_id": "string",
  "status": 0
}

Create segment

POSThttps://api.lytics.io/v2/segment

Create a segment

Sample Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
{
  "account_id": "string",
  "aid": 0,
  "ast": {
    "args": [
      {}
    ],
    "ident": "string",
    "op": "string",
    "val": "string"
  },
  "author_id": "string",
  "category": "string",
  "created": "string",
  "datemath_calc": true,
  "deleted": true,
  "description": "string",
  "field_changes_fields": [
    "string"
  ],
  "fields": [
    "string"
  ],
  "forward_datemath": true,
  "groups": [
    "string"
  ],
  "id": "string",
  "identities": [
    "string"
  ],
  "includes": [
    "string"
  ],
  "invalid": true,
  "invalid_reason": "string",
  "is_public": true,
  "kind": "string",
  "name": "string",
  "public_name": "string",
  "ql_resolved": "string",
  "save_hist": true,
  "schedule_exit": true,
  "segment_ql": "string",
  "size": 0,
  "slug_name": "string",
  "table": "string",
  "tags": [
    "string"
  ],
  "updated": "string",
  "withs_ql": "string"
}
Sample Response
Status|201 Created
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "aid": 0,
    "ast": {
      "args": [
        {}
      ],
      "ident": "string",
      "op": "string",
      "val": "string"
    },
    "author_id": "string",
    "category": "string",
    "created": "string",
    "datemath_calc": true,
    "deleted": true,
    "description": "string",
    "field_changes_fields": [
      "string"
    ],
    "fields": [
      "string"
    ],
    "forward_datemath": true,
    "groups": [
      "string"
    ],
    "id": "string",
    "identities": [
      "string"
    ],
    "includes": [
      "string"
    ],
    "invalid": true,
    "invalid_reason": "string",
    "is_public": true,
    "kind": "string",
    "name": "string",
    "public_name": "string",
    "ql_resolved": "string",
    "save_hist": true,
    "schedule_exit": true,
    "segment_ql": "string",
    "size": 0,
    "slug_name": "string",
    "table": "string",
    "tags": [
      "string"
    ],
    "updated": "string",
    "withs_ql": "string"
  },
  "request_id": "string",
  "status": 0
}

Delete segments

DELETEhttps://api.lytics.io/v2/segment

Delete multiple segments

Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728
{
  "_meta": {},
  "data": {
    "deleted": [
      "string"
    ],
    "not_deleted": [
      "string"
    ],
    "segments": [
      {
        "deleted": true,
        "id": "string",
        "reason": "string",
        "segments": {
          "property1": [
            "string"
          ],
          "property2": [
            "string"
          ]
        }
      }
    ]
  },
  "request_id": "string",
  "status": 0
}

Add/Remove segment in/from the exclusion list

POSThttps://api.lytics.io/v2/segment/exclude/{operation}

Adds/Removes the passed segment id in/from the exclusion list. Exclusion list allows to exclude all the users from the segment during the export job. Pass auth_id to scope the exclusion to one authorization; workflow-level and auth-level exclusions are combined, never substituted.

Sample Response
Status|200 OK
123456
{
  "_meta": {},
  "data": {},
  "request_id": "string",
  "status": 0
}

Get segment

GEThttps://api.lytics.io/v2/segment/{id}

Get a segment by ID or slug

Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "aid": 0,
    "ast": {
      "args": [
        {}
      ],
      "ident": "string",
      "op": "string",
      "val": "string"
    },
    "author_id": "string",
    "category": "string",
    "created": "string",
    "datemath_calc": true,
    "deleted": true,
    "description": "string",
    "field_changes_fields": [
      "string"
    ],
    "fields": [
      "string"
    ],
    "forward_datemath": true,
    "groups": [
      "string"
    ],
    "id": "string",
    "identities": [
      "string"
    ],
    "includes": [
      "string"
    ],
    "invalid": true,
    "invalid_reason": "string",
    "is_public": true,
    "kind": "string",
    "name": "string",
    "public_name": "string",
    "ql_resolved": "string",
    "save_hist": true,
    "schedule_exit": true,
    "segment_ql": "string",
    "size": 0,
    "slug_name": "string",
    "table": "string",
    "tags": [
      "string"
    ],
    "updated": "string",
    "withs_ql": "string"
  },
  "request_id": "string",
  "status": 0
}

Update segment

PUThttps://api.lytics.io/v2/segment/{id}

Update a segment

Sample Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
{
  "account_id": "string",
  "aid": 0,
  "ast": {
    "args": [
      {}
    ],
    "ident": "string",
    "op": "string",
    "val": "string"
  },
  "author_id": "string",
  "category": "string",
  "created": "string",
  "datemath_calc": true,
  "deleted": true,
  "description": "string",
  "field_changes_fields": [
    "string"
  ],
  "fields": [
    "string"
  ],
  "forward_datemath": true,
  "groups": [
    "string"
  ],
  "id": "string",
  "identities": [
    "string"
  ],
  "includes": [
    "string"
  ],
  "invalid": true,
  "invalid_reason": "string",
  "is_public": true,
  "kind": "string",
  "name": "string",
  "public_name": "string",
  "ql_resolved": "string",
  "save_hist": true,
  "schedule_exit": true,
  "segment_ql": "string",
  "size": 0,
  "slug_name": "string",
  "table": "string",
  "tags": [
    "string"
  ],
  "updated": "string",
  "withs_ql": "string"
}
Sample Response
Status|200 OK
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
{
  "_meta": {},
  "data": {
    "account_id": "string",
    "aid": 0,
    "ast": {
      "args": [
        {}
      ],
      "ident": "string",
      "op": "string",
      "val": "string"
    },
    "author_id": "string",
    "category": "string",
    "created": "string",
    "datemath_calc": true,
    "deleted": true,
    "description": "string",
    "field_changes_fields": [
      "string"
    ],
    "fields": [
      "string"
    ],
    "forward_datemath": true,
    "groups": [
      "string"
    ],
    "id": "string",
    "identities": [
      "string"
    ],
    "includes": [
      "string"
    ],
    "invalid": true,
    "invalid_reason": "string",
    "is_public": true,
    "kind": "string",
    "name": "string",
    "public_name": "string",
    "ql_resolved": "string",
    "save_hist": true,
    "schedule_exit": true,
    "segment_ql": "string",
    "size": 0,
    "slug_name": "string",
    "table": "string",
    "tags": [
      "string"
    ],
    "updated": "string",
    "withs_ql": "string"
  },
  "request_id": "string",
  "status": 0
}

Delete segment

DELETEhttps://api.lytics.io/v2/segment/{id}

Delete a segment

Sample Response
Status|200 OK
123456
{
  "_meta": {},
  "data": {},
  "request_id": "string",
  "status": 0
}
Hide Parameters

Query Parameters

account_idoptionalstring

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

tableoptionalstring

Filter by table

validoptionalstring

Filter by valid (true|false|all)

kindoptionalstring

Filter by kind (segment|goal|aspect|conversion|managed|all)

Headers

Authorizationoptionalstring

Hide Parameters

Query Parameters

account_idoptionalstring

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

Headers

Authorizationoptionalstring

Body Parameters

account_idoptionalstring
aidoptionalinteger
astoptionalobject
ast.argsoptionalobject[]
ast.args[].argsoptionalobject[]
ast.args[].identoptionalstring
ast.args[].opoptionalstring
ast.args[].valoptionalstring
ast.identoptionalstring
ast.opoptionalstring
ast.valoptionalstring
author_idoptionalstring
categoryoptionalstring
createdoptionalstring
datemath_calcoptionalboolean
deletedoptionalboolean
descriptionoptionalstring
field_changes_fieldsoptionalstring[]
fieldsoptionalstring[]
forward_datemathoptionalboolean
groupsoptionalstring[]
idoptionalstring
identitiesoptionalstring[]
includesoptionalstring[]
invalidoptionalboolean
invalid_reasonoptionalstring
is_publicoptionalboolean
kindoptionalstring
nameoptionalstring
public_nameoptionalstring
ql_resolvedoptionalstring
save_histoptionalboolean
schedule_exitoptionalboolean
segment_qloptionalstring
sizeoptionalinteger
slug_nameoptionalstring
tableoptionalstring
tagsoptionalstring[]
updatedoptionalstring
withs_qloptionalstring
Hide Parameters

Query Parameters

account_idoptionalstring

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

idsrequiredstring

The segment IDs

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

operationrequiredstring

Operation add or remove

Query Parameters

account_idoptionalstring

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

workflowoptionalstring

Workflow slug.

segment_idoptionalstring

Segment id. The segment that needs to be added/removed in/from the exclusion list.

auth_idoptionalstring

Authorization id. Scopes the exclusion to jobs delivering through this authorization. Omit workflow to apply it to every workflow using the authorization.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The segment ID or segment slug

Query Parameters

account_idoptionalstring

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

sizesoptionalstring

Include size

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

The segment ID

Query Parameters

account_idoptionalstring

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

Headers

Authorizationoptionalstring

Body Parameters

account_idoptionalstring
aidoptionalinteger
astoptionalobject
ast.argsoptionalobject[]
ast.args[].argsoptionalobject[]
ast.args[].identoptionalstring
ast.args[].opoptionalstring
ast.args[].valoptionalstring
ast.identoptionalstring
ast.opoptionalstring
ast.valoptionalstring
author_idoptionalstring
categoryoptionalstring
createdoptionalstring
datemath_calcoptionalboolean
deletedoptionalboolean
descriptionoptionalstring
field_changes_fieldsoptionalstring[]
fieldsoptionalstring[]
forward_datemathoptionalboolean
groupsoptionalstring[]
idoptionalstring
identitiesoptionalstring[]
includesoptionalstring[]
invalidoptionalboolean
invalid_reasonoptionalstring
is_publicoptionalboolean
kindoptionalstring
nameoptionalstring
public_nameoptionalstring
ql_resolvedoptionalstring
save_histoptionalboolean
schedule_exitoptionalboolean
segment_qloptionalstring
sizeoptionalinteger
slug_nameoptionalstring
tableoptionalstring
tagsoptionalstring[]
updatedoptionalstring
withs_qloptionalstring
Hide Parameters

URL Parameters

idrequiredstring

The segment ID

Query Parameters

account_idoptionalstring

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

Headers

Authorizationoptionalstring