Skip to content

Create a post

POST
/api/tenant/{tenantId}/Posts
curl --request POST \
--url https://api.nimles.com/cms/api/tenant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/Posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fields": { "additionalProperty": { "value": "example", "valueType": "example" } }, "accessibility": "example", "imageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "bannerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "title": "example", "titleLocalized": { "additionalProperty": "example" }, "longTitle": "example", "longTitleLocalized": { "additionalProperty": "example" }, "summary": "example", "summaryLocalized": { "additionalProperty": "example" }, "content": "example", "contentLocalized": { "additionalProperty": "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" } ], "uniqueName": "example", "startDate": "2026-04-15T12:00:00Z", "endDate": "2026-04-15T12:00:00Z", "author": "example", "authorUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "tags": [ "example" ], "postType": "example" }'
tenantId
required
string format: uuid

Your tenant id.

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
nullable
valueType
string
nullable
accessibility
string
nullable
imageId
string format: uuid
nullable
bannerId
string format: uuid
nullable
title
required
string
nullable
titleLocalized
object
key
additional properties
string
longTitle
string
nullable
longTitleLocalized
object
key
additional properties
string
summary
string
nullable
summaryLocalized
object
key
additional properties
string
content
string
nullable
contentLocalized
object
key
additional properties
string
elements
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
type
required
string
nullable
children
Array<object> recursive
properties
object
key
additional properties
styles
object
key
additional properties
css
string
nullable
content
string
nullable
text
string
nullable
contentLocalized
object
key
additional properties
string
contentId
string format: uuid
nullable
uniqueName
required
string
nullable
classNames
string
nullable
uniqueName
required
string
nullable
startDate
string format: date-time
nullable
endDate
string format: date-time
nullable
author
string
nullable
authorUserId
string format: uuid
nullable
tags
Array<string>
nullable
postType
required
string
nullable

Example generated

{
"resourceGroupId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"fields": {
"additionalProperty": {
"value": "example",
"valueType": "example"
}
},
"accessibility": "example",
"imageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"bannerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"title": "example",
"titleLocalized": {
"additionalProperty": "example"
},
"longTitle": "example",
"longTitleLocalized": {
"additionalProperty": "example"
},
"summary": "example",
"summaryLocalized": {
"additionalProperty": "example"
},
"content": "example",
"contentLocalized": {
"additionalProperty": "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"
}
],
"uniqueName": "example",
"startDate": "2026-04-15T12:00:00Z",
"endDate": "2026-04-15T12:00:00Z",
"author": "example",
"authorUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"tags": [
"example"
],
"postType": "example"
}

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
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
relations
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
name
string
nullable
entityId
required
string format: uuid
entityType
required
string
>= 1 characters
relationType
required
string
>= 1 characters
tenantId
string format: uuid
nullable
resourceGroupId
string format: uuid
nullable
creatorId
string format: uuid
nullable
createdDate
string format: date-time
nullable
version
integer format: int32
nullable
lastModified
string format: date-time
nullable
imageId
string format: uuid
nullable
bannerId
string format: uuid
nullable
postType
required
string
nullable
title
required
string
nullable
titleLocalized
object
key
additional properties
string
longTitle
string
nullable
longTitleLocalized
object
key
additional properties
string
summary
string
nullable
summaryLocalized
object
key
additional properties
string
content
string
nullable
contentLocalized
object
key
additional properties
string
elements
Array<object>
nullable
object
fields
object
key
additional properties
object
value
required
nullable
valueType
string
nullable
accessibility
string
nullable
id
string format: uuid
type
required
string
nullable
children
Array<object> recursive
properties
object
key
additional properties
styles
object
key
additional properties
css
string
nullable
content
string
nullable
text
string
nullable
contentLocalized
object
key
additional properties
string
contentId
string format: uuid
nullable
uniqueName
required
string
nullable
classNames
string
nullable
uniqueName
required
string
nullable
startDate
string format: date-time
nullable
endDate
string format: date-time
nullable
author
string
nullable
authorUserId
string format: uuid
nullable
tags
Array<string>
nullable
status
required
string
nullable
published
object recursive
publishedDate
string format: date-time
nullable

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",
"imageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"bannerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"postType": "example",
"title": "example",
"titleLocalized": {
"additionalProperty": "example"
},
"longTitle": "example",
"longTitleLocalized": {
"additionalProperty": "example"
},
"summary": "example",
"summaryLocalized": {
"additionalProperty": "example"
},
"content": "example",
"contentLocalized": {
"additionalProperty": "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"
}
],
"uniqueName": "example",
"startDate": "2026-04-15T12:00:00Z",
"endDate": "2026-04-15T12:00:00Z",
"author": "example",
"authorUserId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"tags": [
"example"
],
"status": "example",
"published": {},
"publishedDate": "2026-04-15T12:00:00Z"
}
}
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
nullable
instance
string
nullable
status
integer format: int32
nullable
title
string
nullable
type
string
nullable
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
nullable
instance
string
nullable
status
integer format: int32
nullable
title
string
nullable
type
string
nullable
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
nullable
title
string
nullable
type
string
nullable
key
additional properties

Example generated

{
"errors": {
"additionalProperty": [
"example"
]
},
"status": 1,
"title": "example",
"type": "example"
}