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. V1
  5. Stream

Stream

markdownView as Markdown

API for creating stream models. A stream is the same as a [data stream](https://learn.lytics.com/product-docs/data-management/using-data-streams#what-are-data-streams?

) and is consumed for ingestion into a given entity table. It is described by its slug, which is the value used to identify the stream in collection as well as in the FROM statement on a given query.

Retrieve a Single Stream

GEThttps://api.lytics.io/api/stream/{id}

Get a stream according to its ID.

Sample Response
Status|200 OK
12345678910111213141516171819
{
  "data": [
    {
      "account_id": "d8e403de6fbf0090b17b42a2bb37716e",
      "aid": 2,
      "channel": "email",
      "created": "2018-07-31T22:41:21.908Z",
      "hidden": false,
      "id": "765ed319ddc918e6bb5f9b1d6359a3c4",
      "method": "",
      "providers": [],
      "slug": "hellow",
      "tables": [],
      "updated": "2018-07-31T22:41:21.908Z"
    }
  ],
  "message": "success",
  "status": 200
}

Update a Stream

PUThttps://api.lytics.io/api/stream/{id}

Update a stream with a given ID. The parameters listed below provided in the PUT request will overwrite the current parameters in the model.

Stream attributes that a user is able to update:

* *slug* (string) ... raw value of the stream as it appears in both queries and collection

* *channel* (string, optional) ... method by which this stream collects data. Only allowable channel types: web, email, mobile, ad, sms, pos

* *label* (string, optional) ... user assignable label, for display in the UI

* *description* (string, optional) ... user assignable description

* *providers* ([]string, optional) ... names of the providers that send data on this stream

Sample Response
Status|200 OK
12345678910111213141516171819
{
  "data": [
    {
      "account_id": "d8e403de6fbf0090b17b42a2bb37716e",
      "aid": 2,
      "channel": "email",
      "created": "2018-07-31T22:41:21.908Z",
      "hidden": false,
      "id": "765ed319ddc918e6bb5f9b1d6359a3c4",
      "method": "",
      "providers": [],
      "slug": "hellow",
      "tables": [],
      "updated": "2018-07-31T22:41:21.908Z"
    }
  ],
  "message": "success",
  "status": 200
}

Delete a Stream

DELETEhttps://api.lytics.io/api/stream/{id}

Delete a stream with a given ID.

Sample Response
Status|200 OK
1
OK

Retrieve a List of Streams from Account

GEThttps://api.lytics.io/api/stream

Get a list of all the streams for an account

Sample Response
Status|200 OK
1
OK

Create a Stream

POSThttps://api.lytics.io/api/stream

JSON Parameters:

* *slug* (string) ... raw value of the stream as it appears in both queries and collection

* *channel* (string) ... method by which this stream collects data. Only allowable channel types: web, email, mobile, ad, sms, pos

* *label* (string, optional) ... user assignable label, for display in the UI

* *description* (string, optional) ... user assignable description

* *tables* ([]string, optional) ... names of the tables to which this stream writes

* *providers* ([]string, optional) ... names of the providers that send data on this stream

* *hidden* (bool, optional) ... whether stream is hidden in stream stats?

* *method* (string, optional) ... either 'bulk' or 'streaming'

Sample Response
Status|200 OK
12345678910111213141516171819
{
  "data": [
    {
      "account_id": "d8e403de6fbf0090b17b42a2bb37716e",
      "aid": 2,
      "channel": "email",
      "created": "2018-07-31T22:41:21.908Z",
      "hidden": false,
      "id": "765ed319ddc918e6bb5f9b1d6359a3c4",
      "method": "",
      "providers": [],
      "slug": "hellow",
      "tables": [],
      "updated": "2018-07-31T22:41:21.908Z"
    }
  ],
  "message": "success",
  "status": 200
}
Hide Parameters

URL Parameters

idrequiredstring

ID of the stream in the form of a hash. You can also use the slug.

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

ID of the stream in the form of a hash. You can also use the slug.

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Hide Parameters

URL Parameters

idrequiredstring

ID of the stream in the form of a hash. You can also use the slug.

Query Parameters

account_idoptionalstring

Your Lytics account ID.

Headers

Authorizationoptionalstring

Hide Parameters

Headers

Authorizationoptionalstring

Hide Parameters

Headers

Authorizationoptionalstring