Skip to main content
Skip table of contents

Section Approval

Get Approval Macro Details

Path

/rest/approvalmacro/1.0/approval

Method

POST

Request Body


CODE
{
	"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


CODE
{
	"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


CODE
{
	"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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.