Cloud
Confluence Cloud / Reference / REST API v2
POST

Create Smart Link in the content tree

Creates a Smart Link in the content tree in the space.

Permissions required: Permission to view the corresponding space. Permission to create a Smart Link in the content tree in the space.

Data Security Policy: Not exempt from app access rules
Scopes
write:embed:confluence

Connect app scope requiredWRITE

Request

Request bodyapplication/json

spaceId

string

Required
title

string

parentId

string

embedUrl

string

Responses

Returned if the Smart Link was successfully created in the content tree.

application/json

allOf [SmartLinkSingle, object]

SmartLinkSingle
object
POST/embeds
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "spaceId": "<string>", "title": "<string>", "parentId": "<string>", "embedUrl": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds`, { method: 'POST', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "id": "<string>", "type": "<string>", "status": "current", "title": "<string>", "parentId": "<string>", "parentType": "page", "position": 61, "authorId": "<string>", "ownerId": "<string>", "createdAt": "<string>", "embedUrl": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" }, "_links": { "base": "<string>" } }
GET

Get Smart Link in the content tree by id

Returns a specific Smart Link in the content tree.

Permissions required: Permission to view the Smart Link in the content tree and its corresponding space.

Data Security Policy: Not exempt from app access rules
Scopes
read:embed:confluence

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

include-collaborators

boolean

include-direct-children

boolean

include-operations

boolean

include-properties

boolean

Responses

Returned if the requested Smart Link in the content tree is returned.

application/json

allOf [SmartLinkSingle, object]

SmartLinkSingle
object
GET/embeds/{id}
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds/{id}`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "id": "<string>", "type": "<string>", "status": "current", "title": "<string>", "parentId": "<string>", "parentType": "page", "position": 61, "authorId": "<string>", "ownerId": "<string>", "createdAt": "<string>", "embedUrl": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" }, "_links": { "base": "<string>" } }
DEL

Delete Smart Link in the content tree

Delete a Smart Link in the content tree by id.

Deleting a Smart Link in the content tree moves the Smart Link to the trash, where it can be restored later

Permissions required: Permission to view the Smart Link in the content tree and its corresponding space. Permission to delete Smart Links in the content tree in the space.

Data Security Policy: Not exempt from app access rules
Scopes
delete:embed:confluence

Connect app scope requiredDELETE

Request

Path parameters

id

integer

Required

Responses

Returned if the Smart Link in the content tree was successfully deleted.

DEL/embeds/{id}
1 2 3 4 5 6 7 8 9 10 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds/{id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());

Rate this page: