The Storyblok connector lets your AI agent act in each user's Storyblok account. Each user connects their own Storyblok API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.
- Tools
- 26
- What they doRead · write · destructive
- 12 · 10 · 412 read10 write4 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Storyblok connection
In AgentKit > Connections, create a Storyblok connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'storyblok'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Storyblok:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'storyblok_spaces_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "storyblok"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Storyblok:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="storyblok_spaces_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Storyblok credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolstoryblok_asset_getGet one asset's details.Read-onlyGet Asset
Get one asset's details. Returns id, filename (URL), alt, title, copyright, focus, content_type, size and folder. Use storyblok_assets_list to find the ID.
Inputs
asset_idstringrequired- Numeric ID of the asset. Get it from storyblok_assets_list. Example: 14417
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_assets_listList assets (images, videos, documents) in a space.Read-onlyList Assets
List assets (images, videos, documents) in a space. Returns assets with id, filename (URL), short_filename, alt, title, content_type, content_length and tags. Use this to find an asset URL to place in story content.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
by_altstring- Filter by alt text. Example: Product shot
by_titlestring- Filter by title. Example: Summer hero
in_folderinteger- Only assets in this asset folder ID; -1 for deleted assets. Example: 1203
is_privateboolean- If true, only private assets. Example: false
pageinteger- Page number, starting at 1. Example: 1
per_pageinteger- Items per page. Default 25, maximum 1000 (100 for tags). Example: 25
searchstring- Search by filename. Example: hero
sort_bystring- Sort, for example created_at:desc or short_filename:asc. Example: created_at:desc
with_tagsstring- Only assets with any of these tags (comma-separated). Example: featured
storyblok_component_getGet one component (block type) with its field schema.Read-onlyGet Component
Get one component (block type) with its field schema. Returns component with id, name, display_name, schema, is_root, is_nestable and component_group_uuid. Use this to see the exact fields a block accepts.
Inputs
component_idstringrequired- Numeric ID of the component. Get it from storyblok_components_list. Example: 4123
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_components_listList the components (block types) defined in a space.Read-onlyList Components
List the components (block types) defined in a space. Returns components with id, name, display_name, schema (field definitions), is_root and is_nestable. Use this to learn which blocks and fields story content can use before writing content.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
by_idsstring- Only components with these IDs (comma-separated). Example: 4123,4124
in_groupstring- Only components in this component folder (UUID). Example: 8a2b1c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d
is_rootboolean- true for only content type blocks, false for only nestable blocks. Example: true
searchstring- Search components by name or display name. Example: teaser
sort_bystring- Sort by a property, for example name:asc or updated_at:desc. Example: name:asc
storyblok_datasource_entries_listList the entries of a datasource.Read-onlyList Datasource Entries
List the entries of a datasource. Returns datasource_entries with id, name, value, dimension_value and position. Use this to read option lists or find an entry ID.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
datasource_idinteger- Numeric ID of the datasource. Use this or datasource_slug. Example: 91234
datasource_slugstring- Slug of the datasource. Use this or datasource_id. Example: product-categories
dimensioninteger- Dimension ID, to return each entry's dimension_value. Example: 3312
pageinteger- Page number, starting at 1. Example: 1
per_pageinteger- Items per page. Default 25, maximum 1000 (100 for tags). Example: 25
searchstring- Search entry names. Example: shoes
storyblok_datasources_listList datasources (key-value lists such as options or translations) in a space.Read-onlyList Datasources
List datasources (key-value lists such as options or translations) in a space. Returns datasources with id, name, slug and dimensions. Use this to find a datasource_id for its entries.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
pageinteger- Page number, starting at 1. Example: 1
per_pageinteger- Items per page. Default 25, maximum 1000 (100 for tags). Example: 25
storyblok_releases_listList the releases (scheduled bundles of changes) in a space.Read-onlyList Releases
List the releases (scheduled bundles of changes) in a space. Returns releases with id, name, release_at and released. Use this to find a release_id for storyblok_story_create or storyblok_story_update.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_space_getGet one space's settings.Read-onlyGet Space
Get one space's settings. Returns the space with id, name, domain, languages, default_root, stories_count, assets_count and plan details. Use this to check enabled languages and limits.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_spaces_listList the Storyblok spaces the token can access in this region.Read-onlyList Spaces
List the Storyblok spaces the token can access in this region. Returns spaces with id, name, domain, plan, region and created_at. Use this to find a space_id for the other tools. Use storyblok_space_get for one space's settings.
Inputs
This tool takes no inputs.
storyblok_stories_listList stories (content entries) and folders in a space, filtered by text, slug, tag, block, folder or publish state.Read-onlyList Stories
List stories (content entries) and folders in a space, filtered by text, slug, tag, block, folder or publish state. Returns stories with id, uuid, name, slug, full_slug, is_folder, published and updated_at, without their content. The total count is in a response header. Use this to find a story_id. Use storyblok_story_get for the content.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
by_idsstring- Only stories with these IDs (comma-separated). Example: 369689,369690
by_slugsstring- Only stories with these full slugs (comma-separated; * wildcards allowed). Example: blog/*
contain_componentstring- Only stories whose content contains all these blocks (comma-separated). Example: teaser,hero
folder_onlyboolean- If true, return only folders. Example: false
in_trashboolean- If true, return only deleted stories. Example: false
is_publishedboolean- true for only published stories, false for only drafts or unpublished. Example: true
pageinteger- Page number, starting at 1. Example: 1
per_pageinteger- Items per page. Default 25, maximum 1000 (100 for tags). Example: 25
searchstring- Search stories by name, slug or full slug. Example: about
sort_bystring- Sort by a story property or content field, for example created_at:desc or content.FIELD:asc. Example: updated_at:desc
starts_withstring- Only stories whose full slug starts with this. Example: blog/
story_onlyboolean- If true, return only stories, not folders. Example: true
text_searchstring- Search for a string anywhere in stories, including content fields. Example: summer sale
with_parentinteger- Only stories in this parent folder ID. Example: 369680
with_summaryboolean- If true, include a content_summary object for each story. Example: true
with_tagstring- Only stories with these tags (comma-separated). Example: featured
storyblok_story_getGet one story with its full content.Read-onlyGet Story
Get one story with its full content. Returns story with id, uuid, name, slug, full_slug, content (the blocks and fields), tag_list, published state and timestamps. Use this before storyblok_story_update to read the current content.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
storyblok_component_createCreate a component (block type) with its field schema.WriteCreate Component
Create a component (block type) with its field schema. Returns the created component with id and schema. Use this to add a new block type before using it in story content. Use storyblok_component_update to change fields.
Inputs
namestringrequired- Technical name of the block, used as component in story content. Example: banner_section
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
component_group_idstring- Component folder to put the block in. Example: 8a2b1c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d
display_namestring- Name shown in the editor. Example: Banner Section
is_nestableboolean- If true, the block can be nested inside other blocks. Example: true
is_rootboolean- If true, the block can be used as a content type (the root of a story). Example: false
preview_fieldstring- Field shown as the block's preview in the editor. Example: headline
schemaobject- Field definitions keyed by field name; each has a type (text, textarea, richtext, asset, bloks, option, number, boolean, datetime and more) and a pos. Example: {"headline": {"type": "text", "pos": 0, "translatable": true}, "image": {"type": "asset", "filetypes": ["images"], "pos": 1}}
storyblok_component_updateUpdate a component's names, field schema or block type flags.WriteUpdate Component
Update a component's names, field schema or block type flags. Returns the updated component. Use this to add or change fields; send the full schema, since it replaces the current one.
- Idempotent
Inputs
component_idstringrequired- Numeric ID of the component. Get it from storyblok_components_list. Example: 4123
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
display_namestring- New display name. Example: Banner
is_nestableboolean- Whether the block can be nested. Example: true
is_rootboolean- Whether the block can be a content type. Example: false
namestring- New technical name. Renaming breaks existing content that uses the old name. Example: banner_section
preview_fieldstring- Field shown as the preview. Example: headline
schemaobject- Complete field definitions; they replace the current schema. Example: {"headline": {"type": "text", "pos": 0, "translatable": true}, "image": {"type": "asset", "filetypes": ["images"], "pos": 1}}
storyblok_datasource_createCreate a datasource, a reusable list of key-value entries.WriteCreate Datasource
Create a datasource, a reusable list of key-value entries. Returns the datasource with id, name and slug. Add entries afterwards with storyblok_datasource_entry_create.
Inputs
namestringrequired- Datasource name. Example: Product Categories
slugstringrequired- Datasource slug, unique in the space. Example: product-categories
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_datasource_entry_createAdd a key-value entry to a datasource.WriteCreate Datasource Entry
Add a key-value entry to a datasource. Returns the entry with id, name and value. Use storyblok_datasource_entry_update to change an entry.
Inputs
datasource_idintegerrequired- Numeric ID of the datasource to add to. Example: 91234
namestringrequired- Entry key. Example: shoes
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
valuestringrequired- Entry value. Example: Shoes & Sneakers
storyblok_datasource_entry_updateChange a datasource entry's key, value, position or a dimension value.WriteUpdate Datasource Entry
Change a datasource entry's key, value, position or a dimension value. Returns a success status with no body. Use storyblok_datasource_entries_list to find the entry ID.
- Idempotent
Inputs
datasource_entry_idstringrequired- Numeric ID of the datasource entry. Get it from storyblok_datasource_entries_list. Example: 158405385177293
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
dimension_idinteger- Dimension ID; required when setting dimension_value. Example: 3312
dimension_valuestring- Value for a dimension (for example a translation); needs dimension_id. Example: Schuhe
namestring- New entry key. Example: shoes
positioninteger- Sort position of the entry. Example: 1
valuestring- New entry value. Example: Shoes and Sneakers
storyblok_story_createCreate a story (content entry) or folder in a space, as a draft or published.WriteCreate Story
Create a story (content entry) or folder in a space, as a draft or published. Returns the created story with id, uuid, full_slug and content. Use this to add new content. Use storyblok_story_update to change an existing story.
Inputs
namestringrequired- Story name shown in the editor. Example: Summer Sale 2026
slugstringrequired- URL slug, unique within its folder. Example: summer-sale-2026
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
contentobject- Story content: an object whose component is a content type block (for example page), with that block's fields. Leave empty to create a folder. Example: {"component": "page", "body": [{"component": "teaser", "headline": "Hello world"}]}
is_folderboolean- If true, create a folder instead of a story. Example: false
parent_idinteger- ID of the folder to create the story in; 0 or empty for the root. Example: 369680
publishboolean- If true, publish the story right away; otherwise it is saved as a draft. Example: false
release_idinteger- Release to add the story to. Example: 5021
tag_listarray- Tags to assign. Example: ["featured", "campaign"]
storyblok_story_duplicateCopy a story, optionally into another folder and with new attributes.WriteDuplicate Story
Copy a story, optionally into another folder and with new attributes. Returns the new story. Use this to start a variant or a translation from an existing story.
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
same_pathboolean- If true, the copy keeps the original story's path. Example: false
storyobject- Attributes to set on the copy, for example a new name and slug, or a group_id to link it as an alternate. Example: {"name": "Summer Sale 2026 (copy)", "slug": "summer-sale-2026-copy"}
target_dimensioninteger- ID of the folder to put the copy in. Example: 369680
storyblok_story_publishPublish the current draft of a story so it is live in the Content Delivery API.WritePublish Story
Publish the current draft of a story so it is live in the Content Delivery API. Returns a success status; read the story with storyblok_story_get to confirm published_at. Use this after storyblok_story_create or storyblok_story_update saved a draft. Use storyblok_story_unpublish to take it offline.
- Idempotent
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
langstring- Comma-separated language codes to act on only those translations; use [default] for the default language. Languages must be enabled under Settings > Internationalization. Example: de,[default]
storyblok_story_unpublishUnpublish a story so it is no longer delivered, keeping it as a draft.WriteUnpublish Story
Unpublish a story so it is no longer delivered, keeping it as a draft. Returns a success status. Use this to take content offline. Use storyblok_story_delete to remove it.
- Idempotent
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
langstring- Comma-separated language codes to act on only those translations; use [default] for the default language. Languages must be enabled under Settings > Internationalization. Example: de,[default]
storyblok_story_updateUpdate a story's name, slug, content, folder or tags, and optionally publish the change.WriteUpdate Story
Update a story's name, slug, content, folder or tags, and optionally publish the change. Returns the updated story. Use this to edit content. Content is replaced as a whole, so read it first with storyblok_story_get. Use storyblok_story_publish to publish without editing.
- Idempotent
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
contentobject- New content. It replaces the whole content object, so read the story first with storyblok_story_get and send the full updated content. Example: {"component": "page", "body": [{"component": "teaser", "headline": "Hello world"}]}
force_updatestring- Set to 1 to update a story that another user has locked. Example: 1one of
1 langstring- Language code to publish individually when publish is true. Example: de
namestring- New story name. Example: Summer Sale 2026 (extended)
parent_idinteger- Move the story to this folder ID. Example: 369680
publishboolean- If true, publish the changes; otherwise save them as a draft. Example: true
release_idinteger- Release to save the changes into. Example: 5021
slugstring- New URL slug. Example: summer-sale-2026-extended
tag_listarray- Replacement list of tags. Example: ["featured"]
storyblok_asset_deleteDelete an asset.DestructiveDelete Asset
Delete an asset. Returns the deleted asset. Stories that still reference its URL will show a broken file.
- Idempotent
Inputs
asset_idstringrequired- Numeric ID of the asset. Get it from storyblok_assets_list. Example: 14417
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_component_deleteDelete a component (block type).DestructiveDelete Component
Delete a component (block type). Returns the deleted component. Stories that still use the block keep its data but can no longer edit it.
- Idempotent
Inputs
component_idstringrequired- Numeric ID of the component. Get it from storyblok_components_list. Example: 4123
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_datasource_entry_deleteDelete a datasource entry.DestructiveDelete Datasource Entry
Delete a datasource entry. Returns a success status with no body. Use this to remove an option from a list.
- Idempotent
Inputs
datasource_entry_idstringrequired- Numeric ID of the datasource entry. Get it from storyblok_datasource_entries_list. Example: 158405385177293
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
storyblok_story_deleteDelete a story or folder (it moves to the trash).DestructiveDelete Story
Delete a story or folder (it moves to the trash). Returns the deleted story. Use storyblok_story_unpublish instead to only take it offline.
- Idempotent
Inputs
space_idstringrequired- Numeric ID of the Storyblok space. Find it with storyblok_spaces_list or in the space's Settings > Space. Example: 288868932106293
story_idstringrequired- Numeric ID of the story. Get it from storyblok_stories_list. Example: 369689
No tools match.