Partially updates a metaobject. The body is a JSON Merge Patch document: change the handle, status, or individual fields values. Updated field values are re-validated against the definition.
Headers
Name
Type
Required
Description
X-Flowkiwi-Organization-Id
string
required
The organization the request acts as. Determines the identity, permissions and ownership applied when reading or modifying data on the instance.
Path parameters
Name
Type
Required
Description
id
string
required
Metaobject identifier
Request body
Property
Type
Required
Description
status
"DRAFT" | "ACTIVE"
-
The publication status of the metaobject.
fields
MetaobjectFieldInput[]
-
The field values of the metaobject, one entry per field definition.
Show fields fields
Property
Type
Required
Description
key
string
required
value
string | null
-
Response
200 - Metaobject resource updated
Property
Type
Required
Description
@context
object
-
@id
string
required
@type
string
required
id
string
-
The resource's unique identifier (UUID).
definition
string
-
The MetaobjectDefinition (IRI) this metaobject is a record of.
handle
string
-
The metaobject's unique slug within its definition type.
status
"DRAFT" | "ACTIVE"
-
The publication status of the metaobject.
displayName
string | null
-
The human-readable label, derived from the field named by the definition's displayNameField.
Property
Type
Required
Description
id
string
-
The resource's unique identifier (UUID).
definition
string
-
The MetaobjectDefinition (IRI) this metaobject is a record of.
handle
string
-
The metaobject's unique slug within its definition type.
status
"DRAFT" | "ACTIVE"
-
The publication status of the metaobject.
displayName
string | null
-
The human-readable label, derived from the field named by the definition's displayNameField.
fields
EmbeddedMetaobjectFieldResource[]
-
The field values of the metaobject, one entry per field definition.
Show fields fields
Property
Type
Required
Description
key
string
-
The field key (matches a field definition key).
value
string | null
-
The field value, stored as a string regardless of the field type.
type
string
-
The field data type, as an IRI to the field-type resource.
metaobject
Metaobject[]
-
Show metaobject fields
Property
Type
Required
Description
id
string
-
The resource's unique identifier (UUID).
definition
string
-
The MetaobjectDefinition (IRI) this metaobject is a record of.
handle
string
-
The metaobject's unique slug within its definition type.
status
"DRAFT" | "ACTIVE"
-
The publication status of the metaobject.
displayName
string | null
-
The human-readable label, derived from the field named by the definition's displayNameField.
fields
EmbeddedMetaobjectFieldResource[]
-
The field values of the metaobject, one entry per field definition.
createdAt
string
-
The date and time when the resource was created (ISO 8601 format).
updatedAt
string
-
The date and time when the resource was last modified (ISO 8601 format).
createdAt
string
-
The date and time when the resource was created (ISO 8601 format).
updatedAt
string
-
The date and time when the resource was last modified (ISO 8601 format).
Errors
400 - Invalid input
Property
Type
Required
Description
@context
object
-
@id
string
required
@type
string
required
title
string | null
-
A short, human-readable summary of the problem.
detail
string | null
-
A human-readable explanation specific to this occurrence of the problem.
status
number | null
-
instance
string | null
-
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
type
string
-
A URI reference that identifies the problem type
Property
Type
Required
Description
title
string | null
-
A short, human-readable summary of the problem.
detail
string | null
-
A human-readable explanation specific to this occurrence of the problem.
status
number | null
-
instance
string | null
-
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
type
string
-
A URI reference that identifies the problem type
403 - Access denied. The caller is missing one or more identity permissions required for this operation.
Content-Type:application/problem+json
Property
Type
Required
Description
@context
object
-
@id
string
required
@type
string
required
type
string
-
title
string
-
status
integer
-
detail
string
-
missingPermissions
string[]
-
Identity permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied identity:* permission.
404 - Not found
Property
Type
Required
Description
@context
object
-
@id
string
required
@type
string
required
title
string | null
-
A short, human-readable summary of the problem.
detail
string | null
-
A human-readable explanation specific to this occurrence of the problem.
status
number | null
-
instance
string | null
-
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
type
string
-
A URI reference that identifies the problem type
Property
Type
Required
Description
title
string | null
-
A short, human-readable summary of the problem.
detail
string | null
-
A human-readable explanation specific to this occurrence of the problem.
status
number | null
-
instance
string | null
-
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.