curl --request POST \
--url https://staging.api.us.aptlydone.com/matrix/v1/matrix \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"matrixName": "Moen, Ullrich and Abbott Approval Matrix",
"matrixDescription": "Sol cohors succurro fugit conculco tardus deripio ambitus vigor.",
"copiedFrom": "deefb72e-9357-4f87-b04e-c23f725ad83d",
"matrixStatusId": "902bf8f0-a3ee-4aef-9cf7-021a7025c001",
"authorityMatrix": true,
"roleMatrix": true,
"authorityRoleIds": [
"8cdb1f64-5288-43b0-89ef-d78d9fc51998",
"04f533c2-21af-43bc-8acf-6187676ca77a"
],
"tenantId": "e83401bd-1b53-4618-8953-9418774f5e0f",
"ownerId": "8c7eb177-a5a0-4ab7-b73e-c063645ecc75",
"groupIds": [
"0adfe5a8-a45e-4feb-af22-6baf2b21618c",
"08108ca4-23c0-4dfa-8cad-919c7118bc18"
],
"positionIds": [
"4fca9a9c-2621-4dbc-b6d4-ef48037003fd",
"d663c12e-e50a-4806-b634-ecbe3d792d34"
],
"userIds": [
"14a13aaa-7c1b-4865-b33c-3a8dfa26c7fa",
"f1891c7f-ac91-4dc6-873d-2b631865bfef"
],
"decisionIds": [
"3031f513-3152-4b50-ac27-def534bf6fc7",
"648548ec-caf5-4442-9e0a-96509d7e209f"
],
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
},
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
}
}
],
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
}
}
],
"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
}
}
curl --request POST \
--url https://staging.api.us.aptlydone.com/matrix/v1/matrix \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"matrixName": "Moen, Ullrich and Abbott Approval Matrix",
"matrixDescription": "Sol cohors succurro fugit conculco tardus deripio ambitus vigor.",
"copiedFrom": "deefb72e-9357-4f87-b04e-c23f725ad83d",
"matrixStatusId": "902bf8f0-a3ee-4aef-9cf7-021a7025c001",
"authorityMatrix": true,
"roleMatrix": true,
"authorityRoleIds": [
"8cdb1f64-5288-43b0-89ef-d78d9fc51998",
"04f533c2-21af-43bc-8acf-6187676ca77a"
],
"tenantId": "e83401bd-1b53-4618-8953-9418774f5e0f",
"ownerId": "8c7eb177-a5a0-4ab7-b73e-c063645ecc75",
"groupIds": [
"0adfe5a8-a45e-4feb-af22-6baf2b21618c",
"08108ca4-23c0-4dfa-8cad-919c7118bc18"
],
"positionIds": [
"4fca9a9c-2621-4dbc-b6d4-ef48037003fd",
"d663c12e-e50a-4806-b634-ecbe3d792d34"
],
"userIds": [
"14a13aaa-7c1b-4865-b33c-3a8dfa26c7fa",
"f1891c7f-ac91-4dc6-873d-2b631865bfef"
],
"decisionIds": [
"3031f513-3152-4b50-ac27-def534bf6fc7",
"648548ec-caf5-4442-9e0a-96509d7e209f"
],
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
},
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
}
}
],
"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": [
{
"id": "435effb5-898b-456b-aabe-4795bd4e260b",
"positionName": "System Administrator",
"autoProvisioned": true
}
]
}
}
],
"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
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Matrix created successfully
The response is of type object
.