Read, publish, unpublish and delete stories in Storyblok spaces with the Management API.
Explore 5 workflow actions for Storyblok Management, including account permissions and operation limits.
2 read actions3 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Delete story
Write
Delete a story; it moves to the space's trash.
Permissions and limits
Account permissions
A Storyblok personal access token with access to the space
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get story
Read
Read one story, draft or published, with its content.
Permissions and limits
Account permissions
A Storyblok personal access token with access to the space
List stories
Read
Read one page of a space's stories, filtered by slug, text, tag, folder or publish state.
Permissions and limits
Account permissions
A Storyblok personal access token with access to the space
Operation limits
The total count is in a response header NodeHub does not return; read pages until one is empty. Filter queries are not offered.
Pagination: page. Check the result for additional pages; a single action may not return every record.
Publish story
Write
Publish a story's current draft, optionally only some languages.
Permissions and limits
Account permissions
A Storyblok personal access token with access to the space
Operation limits
The answer is not documented; NodeHub reports the status. Run Get story to read the story's new state.
Publishing into a release is not offered.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unpublish story
Write
Unpublish a story, optionally only some languages.
Permissions and limits
Account permissions
A Storyblok personal access token with access to the space
Operation limits
The answer is not documented; NodeHub reports the status. Run Get story to read the story's new state.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Storyblok Management. A saved workflow is not a completed provider action.