Create a layout
POST
/api/tenant/{tenantId}/Layouts
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.nimles.com/cms/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Layouts"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"resourceGroupId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"fields\": { \"additionalProperty\": { \"value\": \"example\", \"valueType\": \"example\" } }, \"accessibility\": \"example\", \"elements\": [ { \"fields\": { \"additionalProperty\": { \"value\": \"example\", \"valueType\": \"example\" } }, \"accessibility\": \"example\", \"id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"type\": \"example\", \"children\": [], \"properties\": { \"additionalProperty\": \"example\" }, \"styles\": { \"additionalProperty\": \"example\" }, \"css\": \"example\", \"content\": \"example\", \"text\": \"example\", \"contentLocalized\": { \"additionalProperty\": \"example\" }, \"contentId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"uniqueName\": \"example\", \"classNames\": \"example\" } ], \"width\": 1, \"name\": \"example\", \"description\": \"example\", \"uniqueName\": \"example\", \"styles\": { \"additionalProperty\": \"example\" }, \"css\": \"example\", \"themeId\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"template\": \"example\", \"insertJs\": \"example\", \"integrations\": [ { \"fields\": { \"additionalProperty\": { \"value\": \"example\", \"valueType\": \"example\" } }, \"accessibility\": \"example\", \"id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"enabled\": true, \"name\": \"example\", \"properties\": { \"additionalProperty\": \"example\" } } ], \"hostName\": \"example\", \"classNames\": \"example\", \"layoutType\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://api.nimles.com/cms/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Layouts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"resourceGroupId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","fields":{"additionalProperty":{"value":"example","valueType":"example"}},"accessibility":"example","elements":[{"fields":{"additionalProperty":{"value":"example","valueType":"example"}},"accessibility":"example","id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","type":"example","children":[],"properties":{"additionalProperty":"example"},"styles":{"additionalProperty":"example"},"css":"example","content":"example","text":"example","contentLocalized":{"additionalProperty":"example"},"contentId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","uniqueName":"example","classNames":"example"}],"width":1,"name":"example","description":"example","uniqueName":"example","styles":{"additionalProperty":"example"},"css":"example","themeId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","template":"example","insertJs":"example","integrations":[{"fields":{"additionalProperty":{"value":"example","valueType":"example"}},"accessibility":"example","id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","enabled":true,"name":"example","properties":{"additionalProperty":"example"}}],"hostName":"example","classNames":"example","layoutType":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.nimles.com/cms/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Layouts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "elements": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "type": "example", "children": [], "properties": { "additionalProperty": "example" }, "styles": { "additionalProperty": "example" }, "css": "example", "content": "example", "text": "example", "contentLocalized": { "additionalProperty": "example" }, "contentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "uniqueName": "example", "classNames": "example" } ], "width": 1, "name": "example", "description": "example", "uniqueName": "example", "styles": { "additionalProperty": "example" }, "css": "example", "themeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "template": "example", "insertJs": "example", "integrations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "enabled": true, "name": "example", "properties": { "additionalProperty": "example" } } ], "hostName": "example", "classNames": "example", "layoutType": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”tenantId
required
string format: uuid
Your tenant id.
Request Body
Section titled “Request Body”Media typeapplication/json
object
resourceGroupId
required
The resource group the item is created in. Required: access is checked there.
string format: uuid
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
elements
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
type
required
string
children
Array<object> recursive
properties
object
key
additional properties
styles
object
key
additional properties
css
string
content
string
text
string
contentLocalized
object
key
additional properties
string
contentId
string format: uuid
uniqueName
required
string
classNames
string
width
integer format: int32
name
required
string
description
string
uniqueName
required
string
styles
object
key
additional properties
css
string
themeId
string format: uuid
template
string
insertJs
string
integrations
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
enabled
boolean
name
required
string
properties
object
key
additional properties
string
hostName
string
classNames
string
layoutType
required
string
Example generated
{ "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "elements": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "type": "example", "children": [], "properties": { "additionalProperty": "example" }, "styles": { "additionalProperty": "example" }, "css": "example", "content": "example", "text": "example", "contentLocalized": { "additionalProperty": "example" }, "contentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "uniqueName": "example", "classNames": "example" } ], "width": 1, "name": "example", "description": "example", "uniqueName": "example", "styles": { "additionalProperty": "example" }, "css": "example", "themeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "template": "example", "insertJs": "example", "integrations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "enabled": true, "name": "example", "properties": { "additionalProperty": "example" } } ], "hostName": "example", "classNames": "example", "layoutType": "example"}Responses
Section titled “Responses”Created. The body is the item, or { data: { id } } when it cannot be read yet. Location is the item’s path within the service, /api/tenant/{tenantId}/{Resource}/{id}, without the /{service} prefix api.nimles.com routes by: use data.id from the body.
Media typeapplication/json
One of:
object
fields
object
key
additional properties
string
data
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
relations
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
name
string
entityId
required
string format: uuid
entityType
required
string
relationType
required
string
tenantId
string format: uuid
resourceGroupId
string format: uuid
creatorId
string format: uuid
createdDate
string format: date-time
version
integer format: int32
lastModified
string format: date-time
layoutType
required
string
elements
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
type
required
string
children
Array<object> recursive
properties
object
key
additional properties
styles
object
key
additional properties
css
string
content
string
text
string
contentLocalized
object
key
additional properties
string
contentId
string format: uuid
uniqueName
required
string
classNames
string
width
integer format: int32
name
required
string
description
string
uniqueName
required
string
styles
object
key
additional properties
css
string
themeId
string format: uuid
publishedDate
string format: date-time
template
string
insertJs
string
integrations
Array<object>
object
fields
object
key
additional properties
object
value
required
valueType
string
accessibility
string
id
string format: uuid
enabled
boolean
name
required
string
properties
object
key
additional properties
string
hostName
string
published
object recursive
status
required
string
classNames
string
object
data
The id of a new item, when the create answers before the item can be read.
object
id
string format: uuid
fields
object
key
additional properties
string
Example generated
{ "data": { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "relations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "entityId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entityType": "example", "relationType": "example" } ], "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "creatorId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "createdDate": "2026-04-15T12:00:00Z", "version": 1, "lastModified": "2026-04-15T12:00:00Z", "layoutType": "example", "elements": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "type": "example", "children": [], "properties": { "additionalProperty": "example" }, "styles": { "additionalProperty": "example" }, "css": "example", "content": "example", "text": "example", "contentLocalized": { "additionalProperty": "example" }, "contentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "uniqueName": "example", "classNames": "example" } ], "width": 1, "name": "example", "description": "example", "uniqueName": "example", "styles": { "additionalProperty": "example" }, "css": "example", "themeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "publishedDate": "2026-04-15T12:00:00Z", "template": "example", "insertJs": "example", "integrations": [ { "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "enabled": true, "name": "example", "properties": { "additionalProperty": "example" } } ], "hostName": "example", "published": {}, "status": "example", "classNames": "example" }}Headers
Section titled “Headers”Location
string
The new item’s path within the service, without the service prefix: /api/tenant/{tenantId}/{Resource}/{id}.
Unauthorized: no bearer token, or one that is expired or not for this API.
Forbidden: the caller holds no role that allows this action at this scope. The body is empty, or a problem whose detail names the action.
Media typeapplication/json
An RFC 9457 problem.
object
detail
string
instance
string
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Conflict: the item kept changing under concurrent writes; read it again and retry.
Media typeapplication/problem+json
An RFC 9457 problem.
object
detail
string
instance
string
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "detail": "example", "instance": "example", "status": 1, "title": "example", "type": "example"}Unprocessable: the body or the change is invalid. The errors are keyed by member.
Media typeapplication/problem+json
A validation problem: the messages by member (or by JSON Pointer for a patch).
object
errors
object
key
additional properties
Array<string>
status
integer format: int32
title
string
type
string
key
additional properties
Example generated
{ "errors": { "additionalProperty": [ "example" ] }, "status": 1, "title": "example", "type": "example"}