canonical: https://jentic.com/apis/storyblok.com/storyblok

# Storyblok Management API

Storyblok's Management API for managing spaces, stories, components, assets, and other content management resources. The API exposes 75 endpoints secured with apiKey authentication.

## For AI agents

Programmatically create space, list spaces. Covers 75 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for marketing only.

## Capabilities

- Create Space
- List Spaces
- Get Space
- Update Space
- Delete Space

## Use cases

### Marketing Operations

Use the Storyblok Management API to perform marketing operations programmatically. The API provides 75 endpoints covering core functionality including create space, list spaces, get space.

Example prompt: Call POST /spaces to create space

### Automated Spaces Management

Automate spaces operations by combining multiple Storyblok Management API endpoints. Agents can list spaces and then get space in a single workflow.

Example prompt: Call GET /spaces to list spaces, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Storyblok Management API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'create space', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /spaces | Create Space |
| GET | /spaces | List Spaces |
| GET | /spaces/{space_id} | Get Space |
| PUT | /spaces/{space_id} | Update Space |
| DELETE | /spaces/{space_id} | Delete Space |
| POST | /spaces/{space_id}/stories | Create Story |
| GET | /spaces/{space_id}/stories | List Stories |
| GET | /spaces/{space_id}/stories/{story_id} | Get Story |

## Key resources

- **Spaces** — Operations related to Spaces
- **Stories** — Operations related to Stories
- **Components** — Operations related to Components
- **Component Groups** — Operations related to Component Groups
- **Assets** — Operations related to Assets

## Why Jentic

- **Setup:** Wiring the Storyblok Management API by hand means sending a personal access token in the Authorization header on every call to mapi.storyblok.com/v1 and threading the space context through each story, component, and asset request yourself. Through Jentic you install once, import the Storyblok Management API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Storyblok puts the space id in the URL path (/spaces/{space_id}/...), so a rule can pin your agent to one space: it can manage that space's stories and components and nothing else. You choose the operations it may call, so deleting a space or unpublishing stories is not included unless you add it.
- **Credential handling:** Your Storyblok personal access token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a story in a space' or 'publish a story', and Jentic returns the matching Storyblok Management API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Mailchimp** — Alternative marketing API
- **Hubspot** — Alternative marketing API

## FAQ

### What authentication does the Storyblok Management API use?

The Storyblok Management API uses an API key passed in the `Authorization` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I create space with the Storyblok Management API?

Yes. Use the POST /spaces endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Storyblok Management API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I create space through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create space'. Jentic returns the matching Storyblok Management API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Storyblok Management API have?

The Storyblok Management API exposes 75 endpoints covering spaces, stories, components operations.

### Can I limit what my agent is allowed to do with the Storyblok Management API?

Yes. Because Storyblok puts the space id in the URL path (/spaces/{space_id}/...), a rule in your self-hosted Jentic One instance can pin your agent to a single space so it can manage that space's stories and components and nothing else. You decide which operations it may call, so destructive actions like deleting a space or unpublishing stories are not available unless you explicitly add them. The token you store stays with your own instance and is injected at execution time, so the agent only ever exercises the access you have granted.