Section Approval

Get Approval Macro Details

Path

/rest/approvalmacro/1.0/approval

Method

POST

Request Body



{ "type": "macro", // Type = Macro "pageId": 786462, // The Confluence Page ID "macroId": "23e21970-43d6-4411-aca6-49043737e2ba", // Stored in the Wiki Markup (Unique to Page Version) "uuid":" f5c54fa2-a6ec-433f-afbb-877b9d05fb3d", // Unique Identifier stored in Macro Parameters "version": 1 // The Confluence Page Version }



Response Body



{ "type": "macro", "creatorUsername": "ff80808160e8c8810160e8d6a1210000", "pageId": 786462, "macroId": "23e21970-43d6-4411-aca6-49043737e2ba", "title": "Test", "requestNotifications": true, "statusNotifications": true, "expireOnEdit": false, "quorumSize": 0, "postCommentsEnabled": false, "members": [ { "approvalId": 14, "userKey": "ff80808160e8c8810160e8d6a1210000", "status": "approved", "date": 1550055298599, "avatarUrl": "/confluence/download/attachments/65573/user-avatar", "displayName": "John" } ], "version": 1, "uuid": "f5c54fa2-a6ec-433f-afbb-877b9d05fb3d", "superseded": false }



Possible Errors

  • 404

    • No Page exists as provided

    • No Page Version exists as provided

    • No Approvals for Confluence Record exists as provided

  • 401

    • Anonymous User

    • No Permissions on the Space (Space Permissions)

    • No Permissions on the Page (Page Restrictions)

  • 400

    • Invalid JSON

See response body (JSON) for detailed error information.

Approve/Reject a Macro Approval

Path

/rest/approvalmacro/1.0/approval/action

Method

POST

Request Body



{ "type": "macro", "action": "rejected", // "rejected" or "approved" "pageId": 786462, // The Confluence Page ID "macroId": "23e21970-43d6-4411-aca6-49043737e2ba", // Macro ID stored in the Wiki Markup (Unique to Page Version) "uuid": "f5c54fa2-a6ec-433f-afbb-877b9d05fb3d", // Unique Identifier stored in Macro Parameters "version": 1 // The Confluence Page Version }



Response

  • 200 OK

Possible Errors

  • 404

    • No Page exists as provided

    • No Page Version exists as provided

    • No Approvals for Confluence Record exists as provided

  • 401

    • Anonymous User

    • No Permissions on the Space (Space Permissions)

    • No Permissions on the Page (Page Restrictions)

  • 400

    • Invalid Request - e.g. trying to change an old page version

    • Invalid JSON

See response body (JSON) for detailed error information.