Objects
Create object
Creates a new object in the specified space using a JSON payload. The creation process is subject to rate limiting. The payload must include key details such as the object name, icon, description, body content (which may support Markdown), source URL (required for bookmark objects), template identifier, and the type_key (which is the non-unique identifier of the type of object to create). Post-creation, additional operations (like setting featured properties or fetching bookmark metadata) may occur. The endpoint then returns the full object data, ready for further interactions.
post/v1/spaces/{space_id}/objects
Path parameters
space_idstring required
The ID of the space in which to create the object; must be retrieved from ListSpaces endpoint
Headers
Anytype-Versionstring required
The version of the API to use
Request body
Example request
{
"body": "This is the body of the object. Markdown syntax is supported here.",
"icon": {
"emoji": "📄"
},
"name": "My object",
"properties": [
{
"key": "description",
"text": "Some text..."
}
],
"template_id": "bafyreictrp3obmnf6dwejy5o4p7bderaaia4bdg2psxbfzf44yya5uutge",
"type_key": "page"
}Response
The created object
Example response
{
"object": {
"icon": {
"emoji": "📄"
},
"id": "bafyreie6n5l5nkbjal37su54cha4coy7qzuhrnajluzv5qd5jvtsrxkequ",
"layout": "basic",
"markdown": "# This is the title\n...",
"name": "My object",
"object": "object",
"properties": [
{
"id": "bafyreids36kpw5ppuwm3ce2p4ezb3ab7cihhkq6yfbwzwpp4mln7rcgw7a",
"key": "description",
"name": "Description",
"object": "property",
"text": "Some text..."
}
],
"snippet": "The beginning of the object body...",
"space_id": "bafyreigyfkt6rbv24sbv5aq2hko3bhmv5xxlf22b4bypdu6j7hnphm3psq.23me69r569oi1",
"type": {
"icon": {
"emoji": "📄"
},
"id": "bafyreigyb6l5szohs32ts26ku2j42yd65e6hqy2u3gtzgdwqv6hzftsetu",
"key": "page",
"name": "Page",
"object": "type",
"plural_name": "Pages",
"properties": [
{
"id": "bafyreids36kpw5ppuwm3ce2p4ezb3ab7cihhkq6yfbwzwpp4mln7rcgw7a",
"key": "last_modified_date",
"name": "Last modified date",
"object": "property"
}
]
}
}
}