Create a Space

This endpoint creates a new space.

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

Request Body Properties

space
The Space Object

The space object
- name
  required string
  
  Name of the Space
- domain
  string
  
  Domain for your default preview url
- story_published_hook
  string
  
  Published Webhook URL
- environments
  object[]
  
  Array of name, location (url) objects
- searchblok_id
  number
  
  Searchblok id, if available
- has_pending_tasks
  boolean
  
  If the space has pending tasks like backup, deployment etc

Response Properties

space

The Space Object

The space object

name
string

Name of the Space
domain
string

Domain for your default preview url
uniq_domain
string

Unique Domain for the Storyblok Rendering Service
plan
string

Space Plan
plan_level
number

Plan Level of Space
limits
object

Limits of the space
created_at
string

Creation date (Format: yyyy-MM-dd'T'HH:mm:ssZ)
id
number

ID of the space
role
string

Role of the collaborator, could be admin, editor or custom roles
owner_id
number

Numeric user id of the owner for that space
story_published_hook
string

Published Webhook URL
environments
object[]

Array of name, location (url) objects
stories_count
number

Number of Stories in the Space
parent_id
number

Space id of a possible parent space
assets_count
number

Number of Assets in the Space
searchblok_id
number

Searchblok id, if available
duplicatable
boolean

Is the space globally duplicatable by all users
request_count_today
number

Request Count of the day
exceeded_requests
number

Number of Exceeded Requests
billing_address
object

Billing information used to generate your invoices for this space
routes
string[]

Routes for the Storyblok Rendering Service
trial
boolean

Is the space in trial mode
default_root
string

Component name which will be used as default content type for this folders entries
has_slack_webhook
boolean

Does the space have a slack webhook
has_pending_tasks
boolean

If the space has pending tasks like backup, deployment etc
first_token
string

The oldest available preview token of the space
options
object

Options for backup and language configurations

collaborator

The Collaborator Object

Array of Collaborators of the Space

user
object

The user object inside a collaborator object
role
string

Role of the collaborator, could be admin, editor or custom roles
user_id
number

Numeric ID of the user

permissions

enum[]

Allow specific actions for collaborator in interface and add the permission as array of strings

Permission	Description
publish_stories	Allow publishing of content entries
save_stories	Allow editing and saving of content entries
edit_datasources	Allow editing and saving of datasources
access_commerce	Allow access to commerce app
edit_story_slug	Deny the change of slugs of content entries
move_story	Deny moving of content entries
view_composer	Deny access to visual composer

allowed_paths
number[]

Story ids the user should have access to (acts as whitelist). If no item is selected the user has rights to access all content items.
field_permissions
string[]

Hide specific fields for this user with an array of strings with the schema
id

Numeric id of collaborator
space_role_id
number

Numeric ID of the space role
space_role_ids
number[]

Array of space role ids
space_id
number

Numeric id of the collaborator space

owner
object

The user Object of the Owner

Select a Language

Request

curl "https://mapi.storyblok.com/v1/spaces/" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_OAUTH_TOKEN" \
  -d "{\"space\": {\"name\": \"Example Space\"}}"

Request

// Using the Universal JavaScript Client:
// https://github.com/storyblok/storyblok-js-client
Storyblok.post('/spaces/', {
  "space": {
    "name": "Example Space"
  }
})
  .then(response => {
    console.log(response)
  }).catch(error => { 
    console.log(error)
  })

Request

$client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN');

$payload = [
  "space" =>  [
    "name" =>  "Example Space"
  ]
];

$client->post('/spaces/', $payload)->getBody();

Request

require 'storyblok'
client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN')

payload = {
  "space" =>  {
    "name" =>  "Example Space"
  }
}

client.post('/spaces/', payload)

Request

HttpResponse<String> response = Unirest.post("https://mapi.storyblok.com/v1/spaces/")
  .header("Content-Type", "application/json")
  .header("Authorization", "YOUR_OAUTH_TOKEN")
  .body("{\"space\": {\"name\": \"Example Space\"}}")
  .asString();

Request

var client = new RestClient("https://mapi.storyblok.com/v1/spaces/");
var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN");
request.AddParameter("application/json", "{\"space\": {\"name\": \"Example Space\"}}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Request

import Foundation

let headers = [
  "Content-Type": "application/json",
  "Authorization": "YOUR_OAUTH_TOKEN"
]

let postData = NSData(data: "{\"space\": {\"name\": \"Example Space\"}}".data(using: String.Encoding.utf8)!)
let request = NSMutableURLRequest(url: NSURL(string: "https://mapi.storyblok.com/v1/spaces/")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0)

request.method = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Request

import requests

url = "https://mapi.storyblok.com/v1/spaces/"

querystring = {}

payload = "{\"space\": {\"name\": \"Example Space\"}}"
headers = {
  'Content-Type': "application/json",
  'Authorization': "YOUR_OAUTH_TOKEN"
}

response = requests.request("POST", url, data=payload, headers=headers, params=querystring)

print(response.text)

Prev Retrieve Multiple Spaces

Next Update a Space