--- title: Create a Space Role description: This endpoint allows you to create a new space role. url: https://storyblok.com/docs/api/management/space-roles/create-a-space-role --- # Create a Space Role POST ```html https://mapi.storyblok.com/v1/spaces/:space_id/space_roles ``` This endpoint allows you to create a new space role. ## Path parameters - `:space_id` (required) (number) Numeric ID of a space ## Request body properties - `space_role` (The Space Role Object) The [space role object](/docs/api/management/space-roles/the-space-role-object) ## Response properties - `space_role` (The Space Role Object) The [space role object](/docs/api/management/space-roles/the-space-role-object) ## Examples - cURL ```shellscript curl "https://mapi.storyblok.com/v1/spaces/288868932106293/space_roles/" \ -X POST \ -H "Authorization: YOUR_OAUTH_TOKEN" \ -H "Content-Type: application/json" \ -d "{\"space_role\":{\"allowed_languages\":[\"default\",\"de\"],\"allowed_paths\":[43097198,48581646],\"asset_folder_ids\":[56328,29783],\"branch_ids\":[304011],\"component_ids\":[57584,43743,72760,67535],\"datasource_ids\":[2189],\"field_permissions\":[\"article.title\",\"hero.image\"],\"permissions\":[\"manage_block_library\",\"deny_component_technical_name_update\",\"deny_component_fields_name_update\",\"edit_image\",\"delete_stories\",\"deploy_stories\",\"unpublish_stories\",\"unpublish_folders\",\"publish_stories\",\"publish_folders\",\"manage-non-translatable-fields\",\"manage_tags\"],\"readonly_field_permissions\":[\"hero.RichText_type\",\"hero.TextArea_type\"],\"role\":\"Test role\",\"subtitle\":\"desc\"}}" ``` - JS ```javascript // storyblok-js-client@>=7, node@>=18 import Storyblok from "storyblok-js-client"; const storyblok = new Storyblok({ oauthToken: "YOUR_PERSONAL_ACCESS_TOKEN", }); try { const response = await storyblok.post('spaces/288868932106293/space_roles/', { "space_role": { "allowed_languages": [ "default", "de" ], "allowed_paths": [ 43097198, 48581646 ], "asset_folder_ids": [ 56328, 29783 ], "branch_ids": [ 304011 ], "component_ids": [ 57584, 43743, 72760, 67535 ], "datasource_ids": [ 2189 ], "field_permissions": [ "article.title", "hero.image" ], "permissions": [ "manage_block_library", "deny_component_technical_name_update", "deny_component_fields_name_update", "edit_image", "delete_stories", "deploy_stories", "unpublish_stories", "unpublish_folders", "publish_stories", "publish_folders", "manage-non-translatable-fields", "manage_tags" ], "readonly_field_permissions": [ "hero.RichText_type", "hero.TextArea_type" ], "role": "Test role", "subtitle": "desc" } }) console.log({ response }) } catch (error) { console.log(error) } ``` - PHP ```php $client = new \Storyblok\ManagementClient('YOUR_OAUTH_TOKEN'); $payload = ["space_role" => ["allowed_languages" => ["default","de"],"allowed_paths" => [43097198,48581646],"asset_folder_ids" => [56328,29783],"branch_ids" => [304011],"component_ids" => [57584,43743,72760,67535],"datasource_ids" => [2189],"field_permissions" => ["article.title","hero.image"],"permissions" => ["manage_block_library","deny_component_technical_name_update","deny_component_fields_name_update","edit_image","delete_stories","deploy_stories","unpublish_stories","unpublish_folders","publish_stories","publish_folders","manage-non-translatable-fields","manage_tags"],"readonly_field_permissions" => ["hero.RichText_type","hero.TextArea_type"],"role" => "Test role","subtitle" => "desc"]]; $client->post('spaces/288868932106293/space_roles/', $payload)->getBody(); ``` - Java ```java HttpResponse response = Unirest.post("https://mapi.storyblok.com/v1/spaces/288868932106293/space_roles/") .header("Content-Type", "application/json") .header("Authorization", "YOUR_OAUTH_TOKEN") .body({"space_role":{"allowed_languages":["default","de"],"allowed_paths":[43097198,48581646],"asset_folder_ids":[56328,29783],"branch_ids":[304011],"component_ids":[57584,43743,72760,67535],"datasource_ids":[2189],"field_permissions":["article.title","hero.image"],"permissions":["manage_block_library","deny_component_technical_name_update","deny_component_fields_name_update","edit_image","delete_stories","deploy_stories","unpublish_stories","unpublish_folders","publish_stories","publish_folders","manage-non-translatable-fields","manage_tags"],"readonly_field_permissions":["hero.RichText_type","hero.TextArea_type"],"role":"Test role","subtitle":"desc"}}) .asString(); ``` - C# ```csharp var client = new RestClient("https://mapi.storyblok.com/v1/spaces/288868932106293/space_roles/"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Authorization", "YOUR_OAUTH_TOKEN"); request.AddParameter("application/json", "{\"space_role\":{\"allowed_languages\":[\"default\",\"de\"],\"allowed_paths\":[43097198,48581646],\"asset_folder_ids\":[56328,29783],\"branch_ids\":[304011],\"component_ids\":[57584,43743,72760,67535],\"datasource_ids\":[2189],\"field_permissions\":[\"article.title\",\"hero.image\"],\"permissions\":[\"manage_block_library\",\"deny_component_technical_name_update\",\"deny_component_fields_name_update\",\"edit_image\",\"delete_stories\",\"deploy_stories\",\"unpublish_stories\",\"unpublish_folders\",\"publish_stories\",\"publish_folders\",\"manage-non-translatable-fields\",\"manage_tags\"],\"readonly_field_permissions\":[\"hero.RichText_type\",\"hero.TextArea_type\"],\"role\":\"Test role\",\"subtitle\":\"desc\"}}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` - Python ```python import requests url = "https://mapi.storyblok.com/v1/spaces/288868932106293/space_roles/" querystring = {} payload = {"space_role":{"allowed_languages":["default","de"],"allowed_paths":[43097198,48581646],"asset_folder_ids":[56328,29783],"branch_ids":[304011],"component_ids":[57584,43743,72760,67535],"datasource_ids":[2189],"field_permissions":["article.title","hero.image"],"permissions":["manage_block_library","deny_component_technical_name_update","deny_component_fields_name_update","edit_image","delete_stories","deploy_stories","unpublish_stories","unpublish_folders","publish_stories","publish_folders","manage-non-translatable-fields","manage_tags"],"readonly_field_permissions":["hero.RichText_type","hero.TextArea_type"],"role":"Test role","subtitle":"desc"}} headers = { 'Content-Type': "application/json", 'Authorization': "YOUR_OAUTH_TOKEN" } response = requests.request("POST", url, data=payload, headers=headers, params=querystring) print(response.text) ``` - Ruby ```ruby require 'storyblok' client = Storyblok::Client.new(oauth_token: 'YOUR_OAUTH_TOKEN') payload = {"space_role" => {"allowed_languages" => ["default","de"],"allowed_paths" => [43097198,48581646],"asset_folder_ids" => [56328,29783],"branch_ids" => [304011],"component_ids" => [57584,43743,72760,67535],"datasource_ids" => [2189],"field_permissions" => ["article.title","hero.image"],"permissions" => ["manage_block_library","deny_component_technical_name_update","deny_component_fields_name_update","edit_image","delete_stories","deploy_stories","unpublish_stories","unpublish_folders","publish_stories","publish_folders","manage-non-translatable-fields","manage_tags"],"readonly_field_permissions" => ["hero.RichText_type","hero.TextArea_type"],"role" => "Test role","subtitle" => "desc"}} client.post('spaces/288868932106293/space_roles/', payload) ``` - Swift ```swift let storyblok = URLSession(storyblok: .mapi(accessToken: .oauth("YOUR_OAUTH_TOKEN"))) var request = URLRequest(storyblok: storyblok, path: "spaces/288868932106293/space_roles/") request.httpMethod = "POST" request.httpBody = try JSONSerialization.data(withJSONObject: [ "space_role": [ "allowed_languages": [ "default", "de", ], "allowed_paths": [ 43097198, 48581646, ], "asset_folder_ids": [ 56328, 29783, ], "branch_ids": [ 304011, ], "component_ids": [ 57584, 43743, 72760, 67535, ], "datasource_ids": [ 2189, ], "field_permissions": [ "article.title", "hero.image", ], "permissions": [ "manage_block_library", "deny_component_technical_name_update", "deny_component_fields_name_update", "edit_image", "delete_stories", "deploy_stories", "unpublish_stories", "unpublish_folders", "publish_stories", "publish_folders", "manage-non-translatable-fields", "manage_tags", ], "readonly_field_permissions": [ "hero.RichText_type", "hero.TextArea_type", ], "role": "Test role", "subtitle": "desc", ], ]) let (data, _) = try await storyblok.data(for: request) print(try JSONSerialization.jsonObject(with: data)) ``` - Kotlin ```kotlin val client = HttpClient { install(Storyblok(MAPI)) { accessToken = OAuth("YOUR_OAUTH_TOKEN") } } val response = client.post("spaces/288868932106293/space_roles/") { setBody(buildJsonObject { putJsonObject("space_role") { putJsonArray("allowed_languages") { add("default") add("de") } putJsonArray("allowed_paths") { add(43097198) add(48581646) } putJsonArray("asset_folder_ids") { add(56328) add(29783) } putJsonArray("branch_ids") { add(304011) } putJsonArray("component_ids") { add(57584) add(43743) add(72760) add(67535) } putJsonArray("datasource_ids") { add(2189) } putJsonArray("field_permissions") { add("article.title") add("hero.image") } putJsonArray("permissions") { add("manage_block_library") add("deny_component_technical_name_update") add("deny_component_fields_name_update") add("edit_image") add("delete_stories") add("deploy_stories") add("unpublish_stories") add("unpublish_folders") add("publish_stories") add("publish_folders") add("manage-non-translatable-fields") add("manage_tags") } putJsonArray("readonly_field_permissions") { add("hero.RichText_type") add("hero.TextArea_type") } put("role", "Test role") put("subtitle", "desc") } }) } println(response.body()) ``` ## Pagination - [Previous: Space Roles](/docs/api/management/space-roles) - [Next: Delete a Space Role](/docs/api/management/space-roles/delete-a-space-role)