Get content post information

Method type: GET

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/{CONTENT_ID}

• where {CONTENT_ID} is the page or the blog post

Example URL:

• {CONFLUENCE_URL}/rest/extender/1.0/content/163841

Response format: JSON

Example response:

{
	"hasComments": false,
	"hasChildren": true,
	"lastModificationDateString": "2020-10-26 15:44:29",
	"lastPermissionModificationDate": 1727280841377,
	"lastPermissionModificationDateString": "2024-09-25 18:14:01",
	"creatorName": "not exist",
	"lastModifierName": "not exist",
	"type": "page",
	"creationDate": 1603723469341,
	"version": 1,
	"spaceKey": "ds",
	"spaceName": "Demonstration Space",
	"creationDateString": "2020-10-26 15:44:29",
	"lastModificationDate": 1603723469341,
	"name": "Welcome to Confluence",
	"hasLabels": false,
	"position": 8,
	"id": 163841,
	"hasParent": false,
	"status": "current"
}

Replacing the text on the content (replace all)

Method type: POST

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/{CONTENT_ID}/replaceAll

• where {CONTENT_ID} is the page

Request format: JSON

Example request:

{
    "find": "Jira SD”,
    "replace": “Jira SM”,
    “ignoreCase”: true
}

{
    "find": "Jira SD”,
    "replace": “Jira SM”
}

• find - required - the text you want to replace

• replace - required - the text you want to replace the search text with

• ignoreCase - optional - whether the search text should be case-sensitive - true or false (default)

Response format: JSON

Example response:

{
    "ignoreCase": true,
    "numberOfReplacements": 3,
    "message": "done"
}

Replacing the text on all contents in the space (replace all)

Method type: POST

URL: {CONFLUENCE_URL}/rest/extender/1.0/space/{SPACE_KEY}/content/replaceAll

• where {SPACE_KEY} is the space key

Request format: JSON

Example request:

{
    "find": "Jira SD”,
    "replace": “Jira SM”,
    “ignoreCase”: true
}

{
    "find": "Jira SD”,
    "replace": “Jira SM”
}

• find - required - the text you want to replace

• replace - required - the text you want to replace the search text with

• ignoreCase - optional - whether the search text should be case-sensitive - true or false (default)

Response format: JSON

Example response:

{
    "message": "task 'replaceAll' for space 'DEMO' has been started in the background",
    "status": "done"
}

{
    "message": "API 'replaceAll' for space 'DEMO' is in progress, wait for it to finish [50 of 166]",
    "status": "waiting"
}

Check process status

Method type - GET

URL: {CONFLUENCE_URL}/rest/extender/1.0/space/content/replaceAll/taskStatus

Example response:

{
    "message": "no 'replaceAll' job for the space is running",
    "status": "done"
}

{
    "message": "API 'replaceAll' for space 'DEMO' is in progress, wait for it to finish [100 of 166]",
    "status": "in progress"
}

Add text to the top of the content (prepend)

Method type: POST

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/{CONTENT_ID}/prepend

• where {CONTENT_ID} is the page

Request format: JSON

Example request:

{
    "text": "<p>Update: Please check news</p>"

Response format: JSON

Example response:

{
    "status": "done"
}

Add text to the end of the content (append)

Method type: POST

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/{CONTENT_ID}/append

• where {CONTENT_ID} is the page

Request format: JSON

Example request:

{
    "text": "<p>This is the end of the page</p>"

Response format: JSON

Example response:

{
    "status": "done"
}

Move/reorder page

Method type: POST

URL:

• {CONFLUENCE_URL}/rest/extender/1.0/content/movePage

or

• {CONFLUENCE_URL}/rest/extender/1.0/content/reorderPage

Request format: JSON

Example request:

{
	"sourcePageId": 123456,
	"targetPageId": 987654,
	"position": "below"
}

{
	"sourcePageId": 123456,
	"targetPageId": 987654,
	"position": "above"
}

{
	"sourcePageId": 123456,
	"targetPageId": 987654,
	"position": "append"
}

Response format: JSON

Example response:

{
    "message": "The page 'Test page' already exists in space 'TEST'. You need to rename the page title before moving it."
}

{
    "message": "Page 'Test page (Id: 851977)' moved.",
    "status": "done"
}

{
    "message": "The source page cannot be the same as the target page."
}

Change the creator of all contents in the space created by user

When sometimes a user leaves your company, you can change the content (pages / blogs) he has created to another user instead of an "unknown user"

Method type: PUT

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/changeCreator/space/{SPACE_KEY}/user/{USER_NAME_OR_KEY}

• where {SPACE_KEY} is the space key

• where {USER_NAME_OR_KEY} is the user name or the user key

Request format: JSON

Example request:

{
	"newCreatorName": "johnb"
}

Response format: JSON

Example response:

{
    "total": 1,
    "contentsSkipped": [],
    "contentsChanged": [
        786506
    ],
    "message": "success"
}

{
    "total": 5,
    "contentsSkipped": [],
    "contentsChanged": [
        786508,
        786509,
        786507,
        786514,
        786515
    ],
    "message": "success"
}

Change the creator of all content by id’s

When sometimes a user leaves your company, you can change the content (pages / blogs) he has created to another user instead of an "unknown user"

Method type: PUT

URL: {CONFLUENCE_URL}/rest/extender/1.0/content/changeCreator/contentId

Request format: JSON

Example request:

{
    "contentIds": [
        1111111, 2222222, 786506
    ],
	"newCreatorName": "johnb"
}

Response format: JSON

Example response:

{
    "total": 1,
    "contentsSkipped": [
        1111111,
        2222222
    ],
    "contentsChanged": [
        786506
    ],
    "message": "success"
}

Get the space contents for which the permissions modification date was changed on a specific date

Method type: GET

URL: {CONFLUENCE_URL}/rest/extender/1.0/permission/space/{SPACE_KEY}/getContentWithPermissionModificationDate

• where {SPACE_KEY} is the space key

Parameters:

• lastPermissionModificationDateFrom - filter spaces by last permission modification date (last permission modification date >= this date; default value = 1900-01-01)

• lastPermissionModificationDateTo - filter spaces by last permission modification date (last permission modification date <= this date; default value = current date)

• dateFormat - define date format for parameters creationDateFrom, creationDateTo and for JSON output fields creationDateString, lastModificationDateString - default format ‘yyyy-MM-dd'

Example URL:

• {CONFLUENCE_URL}/rest/extender/1.0/permission/space/KB/getContentWithPermissionModificationDate?lastPermissionModificationDateTo=2024-09-22

• {CONFLUENCE_URL}/rest/extender/1.0/permission/space/KB/getContentWithPermissionModificationDate?lastPermissionModificationDateFrom=2022-09-22

• {CONFLUENCE_URL}/rest/extender/1.0/permission/space/KB/getContentWithPermissionModificationDate?lastPermissionModificationDateFrom=01.01.2020&dateFormat=MM.dd.yyyy

Response format: JSON

Example response:

{
	"total": 2,
	"maxResults": 100,
	"startAt": 0,
	"content": [
		{
			"lastPermissionModificationDate": 1727280841377,
			"lastPermissionModificationDateString": "2024-09-25 18:14:01",
			"name": "Welcome to Confluence",
			"id": 163841,
			"type": "page",
			"status": "current"
		},
		{
			"lastPermissionModificationDate": 1727280848170,
			"lastPermissionModificationDateString": "2024-09-25 18:14:08",
			"name": "Learn the wonders of autoconvert (step 7 of 9)",
			"id": 163860,
			"type": "page",
			"status": "current"
		}
	]
}

Changes