Skip to content

Create metadata

POST
/v2/metadata

Create new metadata records for aggregates.

X-API-Key
string

API Key

X-API-Secret
string

API Secret

object
aggregates
required

Array of metadata aggregates to create

Array<object>
object
aggregateId
required

The aggregate ID for this metadata group

string format: uuid
77a0049c-7683-45ff-956f-656f257048f7
metadata
required

Array of metadata items for this aggregate

Array<object>
object
typeId
required

The type ID for this metadata item

string format: uuid
77a0049c-7683-45ff-956f-656f257048f7
value
required

The value of the metadata item (can be string, number, boolean, or array)

object
Sample metadata value

Comma-separated list of created metadata IDs.

object
aggregates
required

Array of aggregates with their metadata

Array<object>
object
aggregateId
required

The aggregate ID

string format: uuid
77a0049c-7683-45ff-956f-656f257048f7
metadata
required

Array of metadata items for this aggregate

Array<object>
object
id
required

The query ID for the created metadata

string
77a0049c-7683-45ff-956f-656f257048f7
aggregateId
required

The aggregate ID for this metadata item

string format: uuid
77a0049c-7683-45ff-956f-656f257048f7
value
required

The value of the metadata

string
Sample value
key
required

The key of the metadata

string
77a0049c-7683-45ff-956f-656f257048f7
description
required

The description of the metadata

string
Sample description
displayName
required

The display name of the metadata

string
Sample display name
[
{
"aggregateId": "77a0049c-7683-45ff-956f-656f257048f7",
"metadata": [
{
"id": "987fcdeb-51a2-43d1-9f12-345678901234",
"value": "Some value",
"key": "user_preferences",
"description": "Stores user preferences",
"displayName": "User Preferences"
}
]
}
]

Bad Request

Unauthorized

Forbidden

Not Found

Internal Server Error