Cloud
Confluence Cloud / Reference / REST API v2

Content Properties

Operations
GET/attachments/{attachment-id}/propertiesPOST/attachments/{attachment-id}/propertiesGET/attachments/{attachment-id}/properties/{property-id}PUT/attachments/{attachment-id}/properties/{property-id}DEL/attachments/{attachment-id}/properties/{property-id}GET/blogposts/{blogpost-id}/propertiesPOST/blogposts/{blogpost-id}/propertiesGET/blogposts/{blogpost-id}/properties/{property-id}PUT/blogposts/{blogpost-id}/properties/{property-id}DEL/blogposts/{blogpost-id}/properties/{property-id}GET/custom-content/{custom-content-id}/propertiesPOST/custom-content/{custom-content-id}/propertiesGET/custom-content/{custom-content-id}/properties/{property-id}PUT/custom-content/{custom-content-id}/properties/{property-id}DEL/custom-content/{custom-content-id}/properties/{property-id}GET/pages/{page-id}/propertiesPOST/pages/{page-id}/propertiesGET/pages/{page-id}/properties/{property-id}PUT/pages/{page-id}/properties/{property-id}DEL/pages/{page-id}/properties/{property-id}GET/whiteboards/{id}/propertiesPOST/whiteboards/{id}/propertiesGET/whiteboards/{whiteboard-id}/properties/{property-id}PUT/whiteboards/{whiteboard-id}/properties/{property-id}DEL/whiteboards/{whiteboard-id}/properties/{property-id}GET/databases/{id}/propertiesPOST/databases/{id}/propertiesGET/databases/{database-id}/properties/{property-id}PUT/databases/{database-id}/properties/{property-id}DEL/databases/{database-id}/properties/{property-id}GET/embeds/{id}/propertiesPOST/embeds/{id}/propertiesGET/embeds/{embed-id}/properties/{property-id}PUT/embeds/{embed-id}/properties/{property-id}DEL/embeds/{embed-id}/properties/{property-id}GET/folders/{id}/propertiesPOST/folders/{id}/propertiesGET/folders/{folder-id}/properties/{property-id}PUT/folders/{folder-id}/properties/{property-id}DEL/folders/{folder-id}/properties/{property-id}GET/comments/{comment-id}/propertiesPOST/comments/{comment-id}/propertiesGET/comments/{comment-id}/properties/{property-id}PUT/comments/{comment-id}/properties/{property-id}DEL/comments/{comment-id}/properties/{property-id}
GET

Get content properties for attachment

Retrieves all Content Properties tied to a specified attachment.

Permissions required: Permission to view the attachment.

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

Connect app scope requiredREAD

Request

Path parameters

attachment-id

string

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/attachments/{attachment-id}/properties
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/attachments/{attachment-id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for attachment

Creates a new content property for an attachment.

Permissions required: Permission to update the attachment.

Data Security Policy: Not exempt from app access rules
Scopes
read:attachment:confluence, write:attachment:confluence

Connect app scope requiredWRITE

Request

Path parameters

attachment-id

string

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/attachments/{attachment-id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/attachments/{attachment-id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for attachment by id

Retrieves a specific Content Property by ID that is attached to a specified attachment.

Permissions required: Permission to view the attachment.

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

Connect app scope requiredREAD

Request

Path parameters

attachment-id

string

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/attachments/{attachment-id}/properties/{property-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/attachments/{attachment-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for attachment by id

Update a content property for attachment by its id.

Permissions required: Permission to edit the attachment.

Data Security Policy: Not exempt from app access rules
Scopes
read:attachment:confluence, write:attachment:confluence

Connect app scope requiredWRITE

Request

Path parameters

attachment-id

string

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/attachments/{attachment-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/attachments/{attachment-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for attachment by id

Deletes a content property for an attachment by its id.

Permissions required: Permission to attachment the page.

Data Security Policy: Not exempt from app access rules
Scopes
read:attachment:confluence, write:attachment:confluence

Connect app scope requiredWRITE

Request

Path parameters

attachment-id

string

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/attachments/{attachment-id}/properties/{property-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/attachments/{attachment-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for blog post

Retrieves all Content Properties tied to a specified blog post.

Permissions required: Permission to view the blog post.

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

Connect app scope requiredREAD

Request

Path parameters

blogpost-id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/blogposts/{blogpost-id}/properties
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/blogposts/{blogpost-id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for blog post

Creates a new property for a blogpost.

Permissions required: Permission to update the blog post.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

blogpost-id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/blogposts/{blogpost-id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/blogposts/{blogpost-id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for blog post by id

Retrieves a specific Content Property by ID that is attached to a specified blog post.

Permissions required: Permission to view the blog post.

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

Connect app scope requiredREAD

Request

Path parameters

blogpost-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

Headers

Link

string

application/json

ContentProperty
GET/blogposts/{blogpost-id}/properties/{property-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/blogposts/{blogpost-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for blog post by id

Update a content property for blog post by its id.

Permissions required: Permission to edit the blog post.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

blogpost-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/blogposts/{blogpost-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/blogposts/{blogpost-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for blogpost by id

Deletes a content property for a blogpost by its id.

Permissions required: Permission to edit the blog post.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

blogpost-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/blogposts/{blogpost-id}/properties/{property-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/blogposts/{blogpost-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for custom content

Retrieves Content Properties tied to a specified custom content.

Permissions required: Permission to view the custom content.

Data Security Policy: Not exempt from app access rules
Scopes
read:custom-content:confluence

Connect app scope requiredREAD

Request

Path parameters

custom-content-id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/custom-content/{custom-content-id}/properties
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/custom-content/{custom-content-id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for custom content

Creates a new content property for a piece of custom content.

Permissions required: Permission to update the custom content.

Data Security Policy: Not exempt from app access rules
Scopes
read:custom-content:confluence, write:custom-content:confluence

Connect app scope requiredWRITE

Request

Path parameters

custom-content-id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/custom-content/{custom-content-id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/custom-content/{custom-content-id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for custom content by id

Retrieves a specific Content Property by ID that is attached to a specified custom content.

Permissions required: Permission to view the page.

Data Security Policy: Not exempt from app access rules
Scopes
read:custom-content:confluence

Connect app scope requiredREAD

Request

Path parameters

custom-content-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/custom-content/{custom-content-id}/properties/{property-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/custom-content/{custom-content-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for custom content by id

Update a content property for a piece of custom content by its id.

Permissions required: Permission to edit the custom content.

Data Security Policy: Not exempt from app access rules
Scopes
read:custom-content:confluence, write:custom-content:confluence

Connect app scope requiredWRITE

Request

Path parameters

custom-content-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/custom-content/{custom-content-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/custom-content/{custom-content-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for custom content by id

Deletes a content property for a piece of custom content by its id.

Permissions required: Permission to edit the custom content.

Data Security Policy: Not exempt from app access rules
Scopes
read:custom-content:confluence, write:custom-content:confluence

Connect app scope requiredWRITE

Request

Path parameters

custom-content-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/custom-content/{custom-content-id}/properties/{property-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/custom-content/{custom-content-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for page

Retrieves Content Properties tied to a specified page.

Permissions required: Permission to view the page.

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

Connect app scope requiredREAD

Request

Path parameters

page-id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/pages/{page-id}/properties
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/pages/{page-id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for page

Creates a new content property for a page.

Permissions required: Permission to update the page.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

page-id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/pages/{page-id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/pages/{page-id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for page by id

Retrieves a specific Content Property by ID that is attached to a specified page.

Permissions required: Permission to view the page.

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

Connect app scope requiredREAD

Request

Path parameters

page-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/pages/{page-id}/properties/{property-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/pages/{page-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for page by id

Update a content property for a page by its id.

Permissions required: Permission to edit the page.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

page-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/pages/{page-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/pages/{page-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for page by id

Deletes a content property for a page by its id.

Permissions required: Permission to edit the page.

Data Security Policy: Not exempt from app access rules
Scopes
read:page:confluence, write:page:confluence

Connect app scope requiredWRITE

Request

Path parameters

page-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/pages/{page-id}/properties/{property-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/pages/{page-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for whiteboard

Retrieves Content Properties tied to a specified whiteboard.

Permissions required: Permission to view the whiteboard.

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

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/whiteboards/{id}/properties
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/whiteboards/{id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for whiteboard

Creates a new content property for a whiteboard.

Permissions required: Permission to update the whiteboard.

Data Security Policy: Not exempt from app access rules
Scopes
read:whiteboard:confluence, write:whiteboard:confluence

Connect app scope requiredWRITE

Request

Path parameters

id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/whiteboards/{id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/whiteboards/{id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for whiteboard by id

Retrieves a specific Content Property by ID that is attached to a specified whiteboard.

Permissions required: Permission to view the whiteboard.

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

Connect app scope requiredREAD

Request

Path parameters

whiteboard-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/whiteboards/{whiteboard-id}/properties/{property-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/whiteboards/{whiteboard-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for whiteboard by id

Update a content property for a whiteboard by its id.

Permissions required: Permission to edit the whiteboard.

Data Security Policy: Not exempt from app access rules
Scopes
read:whiteboard:confluence, write:whiteboard:confluence

Connect app scope requiredWRITE

Request

Path parameters

whiteboard-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/whiteboards/{whiteboard-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/whiteboards/{whiteboard-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for whiteboard by id

Deletes a content property for a whiteboard by its id.

Permissions required: Permission to edit the whiteboard.

Data Security Policy: Not exempt from app access rules
Scopes
read:whiteboard:confluence, write:whiteboard:confluence

Connect app scope requiredWRITE

Request

Path parameters

whiteboard-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/whiteboards/{whiteboard-id}/properties/{property-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/whiteboards/{whiteboard-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for database

Retrieves Content Properties tied to a specified database.

Permissions required: Permission to view the database.

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

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/databases/{id}/properties
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/databases/{id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for database

Creates a new content property for a database.

Permissions required: Permission to update the database.

Data Security Policy: Not exempt from app access rules
Scopes
read:database:confluence, write:database:confluence

Connect app scope requiredWRITE

Request

Path parameters

id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/databases/{id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/databases/{id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for database by id

Retrieves a specific Content Property by ID that is attached to a specified database.

Permissions required: Permission to view the database.

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

Connect app scope requiredREAD

Request

Path parameters

database-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/databases/{database-id}/properties/{property-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/databases/{database-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for database by id

Update a content property for a database by its id.

Permissions required: Permission to edit the database.

Data Security Policy: Not exempt from app access rules
Scopes
read:database:confluence, write:database:confluence

Connect app scope requiredWRITE

Request

Path parameters

database-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/databases/{database-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/databases/{database-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for database by id

Deletes a content property for a database by its id.

Permissions required: Permission to edit the database.

Data Security Policy: Not exempt from app access rules
Scopes
read:database:confluence, write:database:confluence

Connect app scope requiredWRITE

Request

Path parameters

database-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/databases/{database-id}/properties/{property-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/databases/{database-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for Smart Link in the content tree

Retrieves Content Properties tied to a specified Smart Link in the content tree.

Permissions required: Permission to view the Smart Link in the content tree.

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

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/embeds/{id}/properties
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}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for Smart Link in the content tree

Creates a new content property for a Smart Link in the content tree.

Permissions required: Permission to update the Smart Link in the content tree.

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

Connect app scope requiredWRITE

Request

Path parameters

id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/embeds/{id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds/{id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for Smart Link in the content tree by id

Retrieves a specific Content Property by ID that is attached to a specified Smart Link in the content tree.

Permissions required: Permission to view the Smart Link in the content tree.

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

Connect app scope requiredREAD

Request

Path parameters

embed-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/embeds/{embed-id}/properties/{property-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/{embed-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for Smart Link in the content tree by id

Update a content property for a Smart Link in the content tree by its id.

Permissions required: Permission to edit the Smart Link in the content tree.

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

Connect app scope requiredWRITE

Request

Path parameters

embed-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/embeds/{embed-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/embeds/{embed-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for Smart Link in the content tree by id

Deletes a content property for a Smart Link in the content tree by its id.

Permissions required: Permission to edit the Smart Link in the content tree.

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

Connect app scope requiredWRITE

Request

Path parameters

embed-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/embeds/{embed-id}/properties/{property-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/{embed-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for folder

Retrieves Content Properties tied to a specified folder.

Permissions required: Permission to view the folder.

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

Connect app scope requiredREAD

Request

Path parameters

id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/folders/{id}/properties
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/folders/{id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for folder

Creates a new content property for a folder.

Permissions required: Permission to update the folder.

Data Security Policy: Not exempt from app access rules
Scopes
read:folder:confluence, write:folder:confluence

Connect app scope requiredWRITE

Request

Path parameters

id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/folders/{id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/folders/{id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for folder by id

Retrieves a specific Content Property by ID that is attached to a specified folder.

Permissions required: Permission to view the folder.

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

Connect app scope requiredREAD

Request

Path parameters

folder-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/folders/{folder-id}/properties/{property-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/folders/{folder-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for folder by id

Update a content property for a folder by its id.

Permissions required: Permission to edit the folder.

Data Security Policy: Not exempt from app access rules
Scopes
read:folder:confluence, write:folder:confluence

Connect app scope requiredWRITE

Request

Path parameters

folder-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/folders/{folder-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/folders/{folder-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for folder by id

Deletes a content property for a folder by its id.

Permissions required: Permission to edit the folder.

Data Security Policy: Not exempt from app access rules
Scopes
read:folder:confluence, write:folder:confluence

Connect app scope requiredWRITE

Request

Path parameters

folder-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/folders/{folder-id}/properties/{property-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/folders/{folder-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
GET

Get content properties for comment

Retrieves Content Properties attached to a specified comment.

Permissions required: Permission to view the comment.

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

Connect app scope requiredREAD

Request

Path parameters

comment-id

integer

Required

Query parameters

key

string

sort

ContentPropertySortOrder

cursor

string

limit

integer

Responses

Returned if the requested content properties are successfully retrieved.

Headers

Link

string

application/json

MultiEntityResult<ContentProperty>
GET/comments/{comment-id}/properties
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/comments/{comment-id}/properties`, { 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 { "results": [ { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } } ], "_links": { "next": "<string>", "base": "<string>" } }
POST

Create content property for comment

Creates a new content property for a comment.

Permissions required: Permission to update the comment.

Data Security Policy: Not exempt from app access rules
Scopes
read:comment:confluence, write:comment:confluence

Connect app scope requiredWRITE

Request

Path parameters

comment-id

integer

Required

Request bodyapplication/json

The content property to be created

key

string

value

any

Responses

Returned if the content property was created successfully.

application/json

ContentProperty
POST/comments/{comment-id}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/comments/{comment-id}/properties`, { 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
GET

Get content property for comment by id

Retrieves a specific Content Property by ID that is attached to a specified comment.

Permissions required: Permission to view the comment.

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

Connect app scope requiredREAD

Request

Path parameters

comment-id

integer

Required
property-id

integer

Required

Responses

Returned if the requested content property is successfully retrieved.

application/json

ContentProperty
GET/comments/{comment-id}/properties/{property-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/comments/{comment-id}/properties/{property-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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
PUT

Update content property for comment by id

Update a content property for a comment by its id.

Permissions required: Permission to edit the comment.

Data Security Policy: Not exempt from app access rules
Scopes
read:comment:confluence, write:comment:confluence

Connect app scope requiredWRITE

Request

Path parameters

comment-id

integer

Required
property-id

integer

Required

Request bodyapplication/json

The content property to be updated.

key

string

value

any

version

object

Responses

Returned if the content property was updated successfully.

application/json

ContentProperty
PUT/comments/{comment-id}/properties/{property-id}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "key": "<string>", "version": { "number": 84, "message": "<string>" } }`; const response = await api.asUser().requestConfluence(route`/wiki/api/v2/comments/{comment-id}/properties/{property-id}`, { method: 'PUT', 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 { "id": "<string>", "key": "<string>", "version": { "createdAt": "<string>", "message": "<string>", "number": 19, "minorEdit": true, "authorId": "<string>" } }
DEL

Delete content property for comment by id

Deletes a content property for a comment by its id.

Permissions required: Permission to edit the comment.

Data Security Policy: Not exempt from app access rules
Scopes
read:comment:confluence, write:comment:confluence

Connect app scope requiredWRITE

Request

Path parameters

comment-id

integer

Required
property-id

integer

Required

Responses

Returned if the content property was deleted successfully.

DEL/comments/{comment-id}/properties/{property-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/comments/{comment-id}/properties/{property-id}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());

Rate this page: