Skip to content

Get Action

GET
/actions/{actionId}

Retrieves a single Action by ID, including its validity period and assigned units. Scoped to the current Space — returns 404 if the Action does not exist or belongs to a different Space.

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

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

object
id
required

Action 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

Action name

string
Example
Fire safety training
type
required

Action type

string
Allowed values: training health check ppe maintenance
Example
training
targetResourceType
required

Target resource type

string
Allowed values: person equipment environment substance
Example
person
validityValue
required

Validity duration value

number
Example
5
validityUnit
required

Validity duration unit

string
Allowed values: year month day
Example
year
units
required

Units this action 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

Unauthorized — missing or invalid JWT

Forbidden — insufficient permissions

Resource not found