Update matrix

curl --request PUT \ --url https://staging.api.us.aptlydone.com/matrix/v1/matrix/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "matrixName": "Stokes, Powlowski and Grimes Approval Matrix", "matrixDescription": "Tenuis corpus vester socius cruciamentum virga cur.", "matrixStatusId": "e52267f2-b11c-487f-8d1c-724d1d427bc6", "authorityMatrix": true, "roleMatrix": true, "authorityRoleIds": [ "85763f72-eb72-4c71-bf30-c9b5e868e690", "cd5a958a-08bc-4440-aead-81fba0a7c7ad" ], "tenantId": "1a29cf6e-fcb2-4fff-9028-f4dfed6e3313", "ownerId": "d807ed2f-dc7c-4ed0-a5b3-ca0c246fbd18", "groupIds": [ "57c50abc-f89c-4238-aa77-7830532bacd1", "4efa37d4-5d58-4806-916c-57ff0cc4bd1f" ], "positionIds": [ "f62e2d31-62e6-4cbf-92c2-8684385601a7", "fc0ad6fd-c7ca-4bcd-90c1-1336f1f921bd" ], "userIds": [ "0f8f8e53-b5d6-4b55-a394-6331419b351f", "2bec2bdd-587b-4c4c-9449-87b359a66bc6" ], "decisionIds": [ "460a5725-af1e-4682-8027-37167e995150", "70acdf5c-b083-4d4b-a312-33c2e51f3847" ], "delegation": { "authorityTypeIds": [ "f0b63af0-99d8-47bb-a567-1ef3cf8cc338", "f3ca4dc6-c85c-4512-abff-d7fecdccff86" ], "delegationRole": true, "roleIds": [ "b2692430-9e07-48bb-bfba-8b736b029192", "6830fc5c-3d3b-43b8-b2c0-49f02c926c8c" ], "issuanceStatusNames": [ "Accepted", "Pending" ], "primaryLimitTypes": { "Value (Currency)": { "min": 1, "max": 2 }, "Time (Months)": { "min": 1, "max": 2 }, "Time (Years)": { "min": 1, "max": 2 }, "Authority": true }, "delegationDataDetails": true, "delegationDataGroups": true, "delegationDataDocuments": true, "delegationDataConditions": true, "delegationDataAuthorities": true, "delegationDataRoles": true }, "authorityFormatting": { "valueAbbrevations": "Actual Values", "valueRounding": "0 decimals", "timeUnit": "Actual Values", "timeRounding": "0 decimals", "delegationIdentification": "Position Username", "displayCurrencyCode": "USD" }, "matrixSharing": { "type": "RESTRICTED", "sharingOption": "ALL_USERS", "groupIds": [ "c45bfb17-0e9e-447b-b334-04322b4a11b7", "00e8de70-332f-488f-b12c-2ed882b86754" ], "userIds": [ "c586ebf8-e01e-42a1-98c4-6b8bc0e359ea", "657b674e-ebba-4c3d-983e-575ef2f792c9" ], "externalSharing": true, "link": true, "viewerAdjustableFilters": true }, "currentTab": "Sharing" }'

{ "statusCode": 200, "timestamp": "2025-06-24T08:51:11.638Z", "message": "Success", "data": { "id": "d1019e1d-b9cd-4a72-873b-b864a49fea82", "matrixId": "10001", "matrixName": "Beahan Group Approval Matrix", "matrixDescription": "Audeo campana speculum thymum accusantium tenus.", "link": "/matrix/view/base64", "roleMatrix": true, "authorityMatrix": true, "tenantId": "b72c2ad3-3676-479c-b6e6-7f754c488663", "ownerId": "05747826-2033-450d-9947-a66ff1766e26", "matrixSections": [ { "sectionId": "2ff23fd9-6dea-4876-8da2-3a43bc58f71a", "name": "Finance" } ], "matrixCategories": [ { "categoryId": "891c8bdd-a089-4f44-ab22-00a5b2911f72", "name": "Approvals" } ], "decisionCount": 5, "delegationCount": 2, "suspendedDelegationsCount": 2, "pendingDelegationsCount": 2, "copiedFromMatrix": "4b9ea214-ddd7-4b5e-b161-d8b903656bb3", "ownerDetails": { "id": "c127e8f7-13da-4a50-859f-8564ed38294b", "email": "[email protected]", "name": "Roy Powlowski I", "firstName": "Dorthy", "lastName": "Kertzmann", "mobilePhone": "635-388-2189 x775", "isActive": true, "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439", "positions": [ "<any>" ] }, "createdOn": "2025-06-24T04:16:48.882Z", "updatedOn": "2025-06-24T00:37:13.311Z", "currentTab": "Sharing", "isFavorite": true, "matrixStatus": { "id": "4a548542-f1c7-444e-9064-dda8ab4168ba", "statusName": "Active", "isActive": true }, "matrixSharing": { "id": "29a1b66a-16ab-4e84-b802-46ff07fffbd9", "type": "SHARED", "sharingOption": "USERS_GROUPS", "link": true, "viewerAdjustableFilters": true, "externalSharing": false, "users": [ { "id": "32fdd6f8-6aaf-4bc6-af89-ea50865b91bf", "userId": "baf5a26a-26ec-475d-a18e-1817a47ca7cc", "userDetails": { "id": "c127e8f7-13da-4a50-859f-8564ed38294b", "email": "[email protected]", "name": "Roy Powlowski I", "firstName": "Dorthy", "lastName": "Kertzmann", "mobilePhone": "635-388-2189 x775", "isActive": true, "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439", "positions": [ "<any>" ] } } ], "groups": [ { "id": "c07b3db7-621e-4d25-bad4-3c6ddc06a4da", "groupId": "cbbb3152-1d16-43ec-a5ad-eb604fbf3f3e", "groupDetails": { "id": "66bc5e67-4a01-4f6c-99d9-75d259ebf088", "groupName": "Finance Department", "tenantId": "251baf0f-d015-4fd3-ba86-28eb729f342c", "groupTypeName": "Department", "groupTypeId": "43754328-308d-43a7-9097-7ebc51474c7a", "status": "ACTIVE", "parentGroupIds": [ "b8be636a-849a-4a09-bc28-e624104e980d" ], "isSynced": false } } ] }, "matrixAuthorityRoles": [ { "id": "9f787fb3-897b-4863-86ca-dc494d49a42e", "authorityRoleId": "320f5be2-3998-4231-8417-ebd9d29f7eeb", "isEnabled": true } ], "matrixGroups": [ { "id": "d087ff44-f5f6-461c-9add-5305e4f60920", "tenantGroupsMappingId": "f9f7efc8-4dca-4914-910a-22915228ce94", "groupDetails": { "id": "66bc5e67-4a01-4f6c-99d9-75d259ebf088", "groupName": "Finance Department", "tenantId": "251baf0f-d015-4fd3-ba86-28eb729f342c", "groupTypeName": "Department", "groupTypeId": "43754328-308d-43a7-9097-7ebc51474c7a", "status": "ACTIVE", "parentGroupIds": [ "b8be636a-849a-4a09-bc28-e624104e980d" ], "isSynced": false } } ], "matrixPositions": [ { "id": "7aa8d2ad-82e2-4dd2-95f5-aca238f8ba5e", "positionId": "c864683d-a440-40df-8561-c310ea3c4e17", "positionDetails": { "id": "e5a73191-c107-47e2-a883-cad51e5abd03", "tenantId": "e9ffaaae-07b0-4960-a32d-80e1f600bd0f", "positionName": "System Administrator", "isScimProvisioned": false, "status": "ACTIVE", "groupIds": [ "b52424e3-a334-4171-818c-d863ac406de4", "a6d41d50-fb63-4e8b-b8a4-241d2534ec25" ] } } ], "matrixUsers": [ { "id": "d5316153-7c42-4a38-9136-4b41c656343f", "userId": "95e4fa48-9fb5-4fa2-b193-df89187be95d", "userDetails": { "id": "c127e8f7-13da-4a50-859f-8564ed38294b", "email": "[email protected]", "name": "Roy Powlowski I", "firstName": "Dorthy", "lastName": "Kertzmann", "mobilePhone": "635-388-2189 x775", "isActive": true, "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439", "positions": [ "<any>" ] } } ], "matrixDecisions": [ { "id": "88ae98b4-62fb-42d5-99cd-6c533840b562", "decisionId": "d5122be0-9c67-4172-942d-d6b53680f519", "isDisabled": false, "disabledOn": null } ], "matrixDelegation": { "authorityTypeIds": [ "f0b63af0-99d8-47bb-a567-1ef3cf8cc338", "f3ca4dc6-c85c-4512-abff-d7fecdccff86" ], "delegationRole": true, "roleIds": [ "b2692430-9e07-48bb-bfba-8b736b029192", "6830fc5c-3d3b-43b8-b2c0-49f02c926c8c" ], "issuanceStatusNames": [ "Accepted", "Pending" ], "primaryLimitTypes": { "Value (Currency)": { "min": 1, "max": 2 }, "Time (Months)": { "min": 1, "max": 2 }, "Time (Years)": { "min": 1, "max": 2 }, "Authority": true }, "delegationDataDetails": true, "delegationDataGroups": true, "delegationDataDocuments": true, "delegationDataConditions": true, "delegationDataAuthorities": true, "delegationDataRoles": true }, "matrixAuthorityFormatting": { "valueAbbrevations": "Actual Values", "valueRounding": "0 decimals", "timeUnit": "Actual Values", "timeRounding": "0 decimals", "delegationIdentification": "Position Username", "displayCurrencyCode": "USD" }, "permissions": [ { "allowed": true, "relationship_key": "<string>" } ], "isUserSavedPersonalView": true } }

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Body

application/json

matrixName

string

required

Matrix name

Example:

"Stokes, Powlowski and Grimes Approval Matrix"

matrixDescription

string

required

Matrix description

Example:

"Tenuis corpus vester socius cruciamentum virga cur."

matrixStatusId

string<uuid>

required

Matrix status ID

Example:

"e52267f2-b11c-487f-8d1c-724d1d427bc6"

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:

"1a29cf6e-fcb2-4fff-9028-f4dfed6e3313"

ownerId

string<uuid>

required

Owner ID

Example:

"d807ed2f-dc7c-4ed0-a5b3-ca0c246fbd18"

authorityRoleIds

string<uuid>[]

Authority role IDs

Example:

[
  "85763f72-eb72-4c71-bf30-c9b5e868e690",
  "cd5a958a-08bc-4440-aead-81fba0a7c7ad"
]

groupIds

string<uuid>[]

Group IDs

Example:

[
  "57c50abc-f89c-4238-aa77-7830532bacd1",
  "4efa37d4-5d58-4806-916c-57ff0cc4bd1f"
]

positionIds

string<uuid>[]

Position IDs

Example:

[
  "f62e2d31-62e6-4cbf-92c2-8684385601a7",
  "fc0ad6fd-c7ca-4bcd-90c1-1336f1f921bd"
]

userIds

string<uuid>[]

User IDs

Example:

[
  "0f8f8e53-b5d6-4b55-a394-6331419b351f",
  "2bec2bdd-587b-4c4c-9449-87b359a66bc6"
]

decisionIds

string<uuid>[]

Decision IDs

Example:

[
  "460a5725-af1e-4682-8027-37167e995150",
  "70acdf5c-b083-4d4b-a312-33c2e51f3847"
]

delegation

object

Delegation

Show child attributes

authorityFormatting

object

Authority formatting

Show child attributes

Matrix sharing options

Show child attributes

currentTab

string

Current tab in create matrix flow

Example:

"Sharing"

Response

200 - application/json

Matrix updated successfully

statusCode

number

required

HTTP Status code

Example:

200

timestamp

string

required

Timestamp of the response

Example:

"2025-06-24T08:51:11.638Z"

message

string

required

Response message

Example:

"Success"

data

object

required

Response data

Show child attributes

API Authentication

Decisions

Delegations

Matrices

Actions

Documents

Tenants

Users

Groups

Positions

Reporting

Notifications

Update matrix

Authorizations

Path Parameters

Body

Response