Developer
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
  • Admin Key
  • Attachment
  • App Properties
  • Ancestors
  • Blog Post
  • Children
  • Classification Level
  • Comment
  • Content
  • Content Properties
  • Custom Content
  • Database
  • Data Policies
  • Descendants
  • Folder
  • Label
  • Like
  • Operation
  • Page
  • Redactions
  • Space
  • Space Permissions
  • Space Properties
  • Space Roles
  • Task
  • User
  • Version
  • Whiteboard
Cloud
Confluence Cloud / Reference / REST API v2

App Properties

Postman Collection
OpenAPI
GET

Get Forge app properties.Experimental

Gets Forge app properties. This API can only be accessed using asApp() requests from Forge.

Data Security Policy: Exempt from app access rules
Scopes
read:app-data:confluence

Connect apps cannot access this REST resource.

Request

Query parameters

cursor

string

limit

integer

Responses

Forge app properties returned on success.

application/json

MultiEntityResult<AppProperty>
GET/app/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 { requestConfluence } from "@forge/bridge"; const response = await requestConfluence(`/wiki/api/v2/app/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 { "results": [ { "key": "<string>", "value": {} } ], "_links": { "next": "<string>", "base": "<string>" } }
GET

Get a Forge app property by key.Experimental

Gets a Forge app property by property key. This API can only be accessed using asApp() requests from Forge.

Data Security Policy: Exempt from app access rules
Scopes
read:app-data:confluence

Connect apps cannot access this REST resource.

Request

Path parameters

propertyKey

string

Required

Responses

App property returned on success.

application/json

object
GET/app/properties/{propertyKey}
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import { requestConfluence } from "@forge/bridge"; const response = await requestConfluence(`/wiki/api/v2/app/properties/{propertyKey}`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 { "key": "user-preferences", "value": { "theme": "dark", "language": "en" } }
PUT

Create or update a Forge app property.Experimental

Creates or updates a Forge app property. This API can only be accessed using asApp() requests from Forge.

Data Security Policy: Exempt from app access rules
Scopes
write:app-data:confluence

Connect apps cannot access this REST resource.

Request

Path parameters

propertyKey

string

Required

Request bodyapplication/json

object

Responses

Property updated.

PUT/app/properties/{propertyKey}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import { requestConfluence } from "@forge/bridge"; var bodyData = `{ "name": "Forge app", "darkMode": true, "version": "1.0.0", "buildNumber": 7 }`; const response = await requestConfluence(`/wiki/api/v2/app/properties/{propertyKey}`, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());
DEL

Deletes a Forge app property.Experimental

Deletes a Forge app property. This API can only be accessed using asApp() requests from Forge.

Data Security Policy: Exempt from app access rules
Scopes
write:app-data:confluence

Connect apps cannot access this REST resource.

Request

Path parameters

propertyKey

string

Required

Responses

Property deleted.

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

Rate this page: