Skip to main content
POST
Declare a typed business input

Authorizations

Authorization
string
header
required

MeshQu API key passed as a bearer token: Authorization: Bearer mqu_…. Mint one in the console (Settings → API keys).

X-MeshQu-Tenant-Id
string
header
required

Tenant UUID for multi-tenant isolation. Required on all authenticated routes — validated before authentication (middleware/tenant.ts), so a missing or non-UUID header returns 400 (MISSING_TENANT_ID / INVALID_TENANT_ID) before the API key is checked.

Body

application/json
label
string
required
Required string length: 1 - 200
value_type
required
Available options:
number
description
string
Maximum string length: 2000
unit
string
Maximum string length: 40
field_name
string
Maximum string length: 128
owner
string
Maximum string length: 200
choices
any[]

The business's list of possible values for this definition, as { code, label } entries. Each entry's shape is validated by the service: a malformed entry is refused 422 INVALID_CHOICE_SHAPE naming choice_index; a repeated code is 422 DUPLICATE_CHOICE_CODE. Business metadata that NEVER edits a rule's allowed values.

Maximum array length: 200

Response

Default Response

field_name
string
required
label
string
required
value_type
required
Available options:
number
declaration_revision
integer
required
reused_existing_binding
boolean
required
description
string
unit
string
owner
string
choices
object[]

The business's list of possible values for this definition — business metadata that NEVER edits a rule's allowed values. Not a permitted subset: the subset a particular list rule allows or forbids lives in the rule. At most 200 entries.

Maximum array length: 200