Skip to content
Omniglass Omniglass Omniglass

Declare a property on a location type

PUT
/location-types/{id}/properties/{property}
 
curl --request PUT \
  --url https://example.com/api/v1/location-types/room/properties/example \
  --header 'Content-Type: application/json' \
  --data '{ "default_value": "example", "required": true }'

Declares a catalog property on a location type, or revises the declaration in place (the line is addressed by name, so the write is idempotent). A shipped (official) type’s contract is writable too: a contract line is a row in its own table and nothing seeds one, so every line is an operator’s. An unknown type is a 404 and a property the catalog does not know is a 422. Gated by location_type:update.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required

The location type, by name or uuid

string

The location type, by name or uuid

property
required

The property name

string

The property name

Request Body required

Section titled “Request Body required ”
Media type application/json
object
$schema

A URL to the JSON Schema for this object.

string format: uri
default_value

The contract default, validated against the property’s data_type; omit for no default

required

Whether every location of this type must set the property; defaults to false

boolean

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json
object
$schema

A URL to the JSON Schema for this object.

string format: uri
default_value

The contract default, shape given by the property’s data_type; omitted when the contract sets none

property_type_id
required

The catalog property’s uuid, the stable form of property_type_name

string
property_type_name
required

The catalog property this location type declares

string
required
required

Whether every location of this type must set the property

boolean
Example 
{
  "$schema": "/api/v1/schemas/LocationTypePropertyBody.json"
}

default

Section titled “default ”

Error

Media type application/problem+json
object
$schema

A URL to the JSON Schema for this object.

string format: uri
detail

A human-readable explanation specific to this occurrence of the problem.

string
errors

Optional list of individual error details

Array<object> | null
object
location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string
message

Error message text

string
value

The value at the given location

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri
status

HTTP status code

integer format: int64
title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string
type

A URI reference to human-readable documentation for the error.

string format: uri
default: about:blank
Example 
{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}