Register Resource
POST
/resources
Registers a new Resource (person, equipment, environment, or substance) in the current Space. The type is immutable after creation — it determines which Actions can apply to this Resource (only Actions whose targetResourceType matches). The Space must be active.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” X-Space-Id
required
string format: uuid
UUID of the target Space (tenant boundary). Validated against user access.
Request Body required
Section titled “Request Body required ”object
name
required
Name of the resource
string
Example
John Smith type
required
Resource type (immutable after creation)
string
Example
personResponses
Section titled “ Responses ”object
id
required
Resource ID
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000 spaceId
required
Space ID
string format: uuid
Example
660e8400-e29b-41d4-a716-446655440000 name
required
Resource name
string
Example
John Smith type
required
Resource type
string
Example
personUnauthorized — missing or invalid JWT
Forbidden — insufficient permissions
Validation failed — invalid input