Skip to navigation

Create an object

View as Markdown

Creates one object of a definition within a space. Authorization: requires space:contribute on :spaceId — lacking it gives 403 (no space:read → 404). Body: { data, fieldMeta? } — data is field values keyed by field key (validated against the definition via JSON Schema; defaults applied); optional fieldMeta accepts only source/locked per key. A unique-field collision returns 409 duplicate_value (with fieldKey); invalid data → 422 validation_failed. Returns 201 with { object }.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
definitionIdstringRequired

Request

This endpoint expects an object.
datamap from strings to anyRequired
Field values keyed by field key.
fieldMetamap from strings to maps from strings to anyOptional

Per-field metadata keyed by field key. Only source and locked are accepted.

Response

The created object.
objectobject

Errors

403
Forbidden Error
409
Conflict Error
422
Unprocessable Entity Error