Skip to main content
POST
Create matrix

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
matrixName
string
required

Matrix name

Example:

"Grady LLC Approval Matrix"

matrixDescription
string
required

Matrix description

Example:

"Umerus odio cervus soleo considero minima utilis synagoga."

matrixStatusId
string<uuid>
required

Matrix status ID

Example:

"7ef3b8cd-83e1-4aea-a993-fd75e1c37eba"

authorityMatrix
boolean
required

Whether this is an authority matrix

Example:

true

roleMatrix
boolean
required

Whether this is a role matrix

Example:

true

tenantId
string<uuid>
required

Tenant ID

Example:

"6d9e0600-7970-4ab7-8c1e-d51f3f4412ec"

ownerId
string<uuid>
required

Owner ID

Example:

"1d69eb11-8c07-455d-807e-07582252c104"

copiedFrom
string<uuid>

Matrix copied from ID

Example:

"c8c0a176-ea46-4f6e-a58b-4eb6431ea8c3"

authorityRoleIds
string<uuid>[]

Authority role IDs

Example:
groupIds
string<uuid>[]

Group IDs

Example:
positionIds
string<uuid>[]

Position IDs

Example:
userIds
string<uuid>[]

User IDs

Example:
decisionIds
string<uuid>[]

Decision IDs

Example:
delegation
object

Delegation

authorityFormatting
object

Authority formatting

matrixSharing
object

Matrix sharing options

matrixExternalSharing
object

Matrix external sharing configuration

currentTab
string

Current tab in create matrix flow

Example:

"Sharing"

Response

201 - application/json

Matrix created successfully

statusCode
number
required

HTTP Status code

Example:

200

timestamp
string
required

Timestamp of the response

Example:

"2026-01-08T06:33:22.023Z"

message
string
required

Response message

Example:

"Success"

data
object
required

Response data