List Stories
storyblok.list_stories
ActionBusiness appsconnection required
Calls the Storyblok API with the connection's credentials.
List a space's stories, with Storyblok's search, tag, publish-state and sort filters. Story objects come back without their content.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Storyblok
- Secret shape
- the personal access token, or {"access_token": "…"}
- Config it needs
- base_url, region, space_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
11 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
space_id Numeric id of the space to act in, from Settings → Space. Overrides the default space on the connection. | string | No | — | — | 123456 |
page Which page of stories to fetch, counting from 1. | number | No | — | ≥ 1 | — |
search Match stories by name, slug or full slug. | string | No | — | — | homepage |
text_search Full-text search across story names, slugs and content. | string | No | — | — | pricing |
by_ids Comma-separated numeric story ids to return, and nothing else. | string | No | — | — | 1234567,1234568 |
by_uuids Comma-separated story UUIDs to return, and nothing else. | string | No | — | — | 0c4f4d1a-1b1d-4d1e-9f2a-2c3d4e5f6a7b |
with_tag Comma-separated tag names; only stories carrying them are returned. | string | No | — | — | blog |
is_published True returns only published stories, false only drafts. Leave unset to return both. | boolean | No | — | — | — |
sort_by Story property and direction to sort by, e.g. created_at:desc. | string | No | — | — | created_at:desc |
folder_only Return only folder stories, not the content entries inside them. | boolean | No | — | — | — |
with_summary Add a content_summary object to each story in place of its content. | boolean | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"by_ids": "1234567,1234568",
"by_uuids": "0c4f4d1a-1b1d-4d1e-9f2a-2c3d4e5f6a7b",
"search": "homepage",
"sort_by": "created_at:desc",
"space_id": "123456",
"text_search": "pricing",
"with_tag": "blog"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
stories The stories on this page, without their content. | array | — |
count How many stories this page returned. | number | — |
total How many stories match in total. | number | — |
per_page How many stories Storyblok puts on a page. | number | — |
space_id The space the stories came from. | string | — |
{
"count": 0,
"per_page": 0,
"space_id": "",
"stories": [],
"total": 0
}Related Storyblok nodes
See List Stories run in a workflow.
In a technical demo we add the Storyblok connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.