Skip to content

Get Resource

GET
/resources/{resourceId}

Retrieves a single Resource by ID, including its type, assigned units, and certificate count. Scoped to the current Space — returns 404 if the Resource does not exist or belongs to a different Space.

resourceId
required
string
X-Space-Id
required
string format: uuid

UUID of the target Space (tenant boundary). Validated against user access.

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
Allowed values: person equipment environment substance
Example
person
units
required

Units this resource is assigned to

Array<object>
object
id
required

Unit ID

string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000
name
required

Unit name

string
Example
Production Department
certificateCount
required

Number of certificates for this resource

number
Example
3

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions

Resource not found