EngineVersion 1osActions

os:ActivateMatrix

os:ActivateMatrix action from the os matrix.

Payload: os:ActivateMatrixPayload

Result: Resource

Activates a matrix at runtime, loading its schema, actions, and capabilities into the current context.

USE os:ActivateMatrix when:

  • You need capabilities from a matrix that isn't yet loaded
  • Discovery (<discover>) returned a relevant matrix URI you want to use

After activation, the matrix's actions and classes become available for use in subsequent scripts.

# Activate a matrix to load its capabilities
DESCRIBE ?result WHERE {
    ?result os:ActivateMatrix ([os:matrixUri "https://example.org/matrix/people"]) .
}