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
}
CODE


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
}
CODE


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
}
CODE


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.