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