Storyblok Raises $80M Series C - Read News

Skip to main content

Management API Reference

INFO:

On May 13th, 2024, Storyblok started gradually rolling out a new design for its Visual Editor. Therefore, the Visual Editor product screenshots depicted in this resource may not match what you encounter in the Storyblok App. For more information and a detailed reference, please consult this FAQ on the new Visual Editor design.

This section outlines the Management API endpoints that can be reached using the OAuth token provided to Custom Sidebar Applications and Tool Plugins. Read more about how to obtain the OAuth token inside of the article OAuth 2.0 API.

Resource Management

Domain: https://mapi.storyblok.com/v1

Stories

GET /spaces/:space_id/stories
POST /spaces/:space_id/stories
GET /spaces/:space_id/stories/:story_id
PUT /spaces/:space_id/stories/:story_id
DELETE /spaces/:space_id/stories/:story_id
GET /spaces/:space_id/stories/:story_id/publish
GET /spaces/:space_id/stories/:story_id/unpublish
GET /spaces/:space_id/stories/:story_id/compare?version=:version_id
GET /spaces/:space_id/stories/:story_id/versions
GET /spaces/:space_id/stories/:story_id/export.json
GET /spaces/:space_id/stories/:story_id/export.json

Collaborators

GET /spaces/:space_id/collaborators
POST /spaces/:space_id/collaborators
PUT /spaces/:space_id/collaborators/:collaborator_id
DELETE /spaces/:space_id/collaborators/:collaborator_id

Components

GET /spaces/:space_id/components
POST /spaces/:space_id/components
GET /spaces/:space_id/components/:component_id
PUT /spaces/:space_id/components/:component_id
DELETE /v1/spaces/:space_id/components/:component_id

Component Groups

GET /spaces/:space_id/component_groups
POST /spaces/:space_id/component_groups
GET /spaces/:space_id/component_groups/:component_group_id
PUT /spaces/:space_id/component_groups/:component_group_id
DELETE /spaces/:space_id/component_groups/:component_group_id

Assets

GET /spaces/:space_id/assets
POST /spaces/:space_id/assets
GET /spaces/:space_id/assets/:asset_id
PUT /spaces/:space_id/assets/:asset_id
DELETE /spaces/:space_id/assets/:asset_id

Asset Folders

GET /spaces/:space_id/asset_folders
POST /spaces/:space_id/asset_folders
GET /spaces/:space_id/asset_folders/:asset_folder_id
PUT /spaces/:space_id/asset_folders/:asset_folder_id
DELETE /spaces/:space_id/asset_folders/:asset_folder_id

Datasources

GET /spaces/:space_id/datasources
POST /spaces/:space_id/datasources
GET /spaces/:space_id/datasources/:datasource_id
PUT /spaces/:space_id/datasources/:datasource_id
DELETE /spaces/:space_id/datasources/:datasource_id

Datasource Entries

GET /spaces/:space_id/datasource_entries
POST /spaces/:space_id/datasource_entries
GET /spaces/:space_id/datasource_entries/:datasource_entry_id
PUT /spaces/:space_id/datasource_entries/:datasource_entry_id
DELETE /spaces/:space_id/datasource_entries/:datasource_entry_id

Space Roles

GET /spaces/:space_id/space_roles
POST /spaces/:space_id/space_roles
GET /spaces/:space_id/space_roles/:space_role_id
PUT /spaces/:space_id/space_roles/:space_role_id
DELETE /spaces/:space_id/space_roles/:space_role_id

Tasks

GET /spaces/:space_id/tasks
POST /spaces/:space_id/tasks
GET /spaces/:space_id/tasks/:task_id
PUT /spaces/:space_id/tasks/:task_id
DELETE /spaces/:space_id/tasks/:task_id

Activities

GET /spaces/:space_id/activities
GET /spaces/:space_id/activities/:activity_id

Presets

GET /spaces/:space_id/presets
POST /spaces/:space_id/presets
GET /spaces/:space_id/presets/:preset_id
PUT /spaces/:space_id/presets/:preset_id
DELETE /spaces/:space_id/presets/:preset_id

Workflows

GET /spaces/:space_id/workflows
POST /spaces/:space_id/workflows
GET /spaces/:space_id/workflows/:workflow_id
PUT /spaces/:space_id/workflows/:workflow_id
DELETE /spaces/:space_id/workflows/:workflow_id

Workflow Stage

GET /spaces/:space_id/workflow_stages
POST /spaces/:space_id/workflow_stages
GET /spaces/:space_id/workflow_stages/:workflow_stage_id
PUT /spaces/:space_id/workflow_stages/:workflow_stage_id
DELETE /spaces/:space_id/workflow_stages/:workflow_stage_id

Workflow Stage Changes

GET /spaces/:space_id/workflow_stage_changes
POST /spaces/:space_id/workflow_stage_changes

Releases

GET /spaces/:space_id/releases
POST /spaces/:space_id/releases
GET /spaces/:space_id/releases/:release_id
PUT /spaces/:space_id/releases/:release_id
DELETE /spaces/:space_id/releases/:release_id

Branch Deployments

POST /spaces/:space_id/deployments

Webhooks

GET /spaces/:space_id/webhook_endpoints
POST /spaces/:space_id/webhook_endpoints
GET /spaces/:space_id/webhook_endpoints/:webhook_id
PUT /spaces/:space_id/webhook_endpoints/:webhook_id
DELETE /spaces/:space_id/webhook_endpoints/:webhook_id

App Provisions

GET /spaces/:space_id/app_provisions/:app_id
PUT /spaces/:space_id/app_provisions/:app_id

Authentication

Domains:

User Info

GET /oauth/user_info

Space Info

GET /oauth/space_info