Space Administration Tools

Tools for managing Storyblok spaces, user roles, permissions, and content branches.

Overview

Space administration tools help you manage your Storyblok infrastructure:

Spaces - Create, configure, and manage spaces
Space Roles - Define custom roles with granular permissions
Branches - Manage content staging environments
Backups - Create space backups

Total tools: 17 (Spaces: 7, Space Roles: 5, Branches: 5)

Spaces (7 tools)

Manage your Storyblok spaces - containers for all your content, components, and assets.

Listing Spaces

fetch_spaces

Purpose: Get all accessible spaces.

Common conversation examples:

Show me all my Storyblok spaces

Returns: Array of space objects.

get_space

Purpose: Get details of a specific space.

Common conversation examples:

Show me details for space ID 12345

Key parameters:

space_id - Space ID (required)

Returns: Single space object.

Creating & Duplicating Spaces

create_space

Purpose: Create a new Storyblok space.

Common conversation examples:

Create a new space called "Marketing Website"

Key parameters:

name - Space name (required)
domain - Domain for space
story_published_hook - Webhook URL
environments - Environment configurations

Returns: Newly created space object.

duplicate_space

Purpose: Duplicate an existing space with all content and settings.

Common conversation examples:

Duplicate space 123 as "Staging Environment"

Key parameters:

original_space_id - Space to duplicate (required)
new_space_name - Name for new space (required)
domain, story_published_hook, environments - Configuration

Returns: Duplicated space object.

Updating Spaces

update_space

Purpose: Update space configuration.

Common conversation examples:

Update space 456 to use domain "www.example.com"

Key parameters:

space_id - Space to update (required)
name, domain, story_published_hook, environments - Updated settings

Returns: Updated space object.

Space Backups

backup_space

Purpose: Create a backup of a space.

Common conversation examples:

Create a backup of space 789

Key parameters:

space_id - Space to backup (required)

Returns: Backup task confirmation.

Deleting Spaces

delete_space

Purpose: Permanently delete a space.

Common conversation examples:

Delete space 999

Key parameters:

space_id - Space to delete (required)

Returns: Deletion confirmation.

Warning: This is permanent and cannot be undone!

Space Roles (5 tools)

Define custom roles with granular permissions for fine-grained access control.

Listing Roles

fetch_space_roles

Purpose: Get all space roles.

Common conversation examples:

Show me all space roles

Key parameters:

search - Filter by name
by_ids - Get specific roles

Returns: Array of space role objects.

get_space_role

Purpose: Get details of a specific role.

Common conversation examples:

Show me space role ID 123

Key parameters:

space_role_id - Role ID (required)

Returns: Single role object.

Creating Roles

create_space_role

Purpose: Create a custom role with specific permissions.

Common conversation examples:

Create a "Content Editor" role that can edit and publish blog posts

Key parameters:

role_name - Role name (required)
permissions - Permission array (required)
allowed_paths - Folder restrictions
field_permissions - Field-level permissions
datasource_ids, component_ids, branch_ids - Resource restrictions
allowed_languages - Language restrictions
asset_folder_ids - Asset folder access

Returns: Newly created role object.

Updating Roles

update_space_role

Purpose: Update role permissions and restrictions.

Common conversation examples:

Update role 456 to allow publishing

Key parameters:

space_role_id - Role to update (required)
All other parameters same as create_space_role

Returns: Updated role object.

Deleting Roles

delete_space_role

Purpose: Delete a custom role.

Common conversation examples:

Delete space role 789

Key parameters:

space_role_id - Role to delete (required)

Returns: Deletion confirmation.

Branches (5 tools)

Manage content branches for staging environments and content isolation.

Listing Branches

retrieve_multiple_branches

Purpose: Get all branches in your space.

Common conversation examples:

Show me all content branches

Key parameters:

by_ids - Filter by specific IDs
search - Search by name

Returns: Array of branch objects.

retrieve_single_branch

Purpose: Get details of a specific branch.

Common conversation examples:

Show me branch ID 123

Key parameters:

branch_id - Branch ID (required)

Returns: Single branch object.

Creating Branches

create_branch

Purpose: Create a new content branch.

Common conversation examples:

Create a "staging" branch

Key parameters:

name - Branch name (required)
source_id - Clone from existing branch
url - Preview URL
position - Display order

Returns: Newly created branch object.

Updating Branches

update_branch

Purpose: Update branch configuration.

Common conversation examples:

Update branch 456 to use new preview URL

Key parameters:

branch_id - Branch to update (required)
name, url, position - Updated settings

Returns: Updated branch object.

Deleting Branches

delete_branch

Purpose: Delete a branch.

Common conversation examples:

Delete branch 789

Key parameters:

branch_id - Branch to delete (required)

Returns: Deletion confirmation.

Need help with space administration? Check out our developer documentation for advanced configuration!