Rate this page:

Space properties

Get space properties

GET /wiki/rest/api/space/{spaceKey}/property

Returns all properties for the given space. Space properties are a key-value storage associated with a space.

Permissions required: ‘View’ permission for the space.

App scope required: READ

OAuth scopes required: 
read:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space to be queried for its properties.

Query parameters
expand

Array<string>

A multi-value parameter indicating which properties of the space property to expand. By default, the version object is expanded.

  • version returns information about the version of the content.
  • space returns the space that the properties are in.
Style: form

Valid values: version, space

start

integer

The starting index of the returned objects.

Default: 0, Minimum: 0, Format: int32
limit

integer

The maximum number of properties to return per page. Note, this may be restricted by fixed system limits.

Default: 10, Minimum: 0, Format: int32

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property' \
  --header 'Accept: application/json'

Responses

Returned if the requested space properties are returned.

Content typeValue
application/json

SpacePropertyArray

Create space property

POST /wiki/rest/api/space/{spaceKey}/property

Creates a new space property.

Permissions required: ‘Admin’ permission for the space.

App scope required: WRITE

OAuth scopes required: 
write:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space that the property will be created in.

Body parameters
key Required

string

The key of the new property.

Maximum: 255
value Required

PropertyValue

The value of the property. This can be empty or a complex object. For example,

1
2
3
4
5
"value": {
  "example1": "value",
  "example2": true,
  "example3": 123
}

Example

1
2
3
4
5
6
7
8
curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "<string>",
  "value": {}
}'

Responses

Returned if the space property is created.

Content typeValue
application/json

SpaceProperty

Get space property

GET /wiki/rest/api/space/{spaceKey}/property/{key}

Returns a space property.

Permissions required: ‘View’ permission for the space.

App scope required: READ

OAuth scopes required: 
read:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space that the property is in.

key Required

string

The key of the space property.

Query parameters
expand

Array<string>

A multi-value parameter indicating which properties of the space property to expand. By default, the version object is expanded.

  • version returns information about the version of the content.
  • space returns the space that the properties are in.
Style: form

Valid values: version, space

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property/{key}' \
  --header 'Accept: application/json'

Responses

Returned if the requested space property is returned.

Content typeValue
application/json

SpaceProperty

Update space property

PUT /wiki/rest/api/space/{spaceKey}/property/{key}

Updates a space property. Note, you cannot update the key of a space property, only the value.

Permissions required: ‘Admin’ permission for the space.

App scope required: WRITE

OAuth scopes required: 
write:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space that the property is in.

key Required

string

The key of the property to be updated.

Body parameters
value Required

object

The value of the property.

version Required

object

The version number of the property.

Example

1
2
3
4
5
6
7
8
9
10
11
curl --request PUT \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property/{key}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "value": {},
  "version": {
    "number": 197,
    "minorEdit": true
  }
}'

Responses

Returned if the space property is updated.

Content typeValue
application/json

SpaceProperty

Create space property for key

POST /wiki/rest/api/space/{spaceKey}/property/{key}

Creates a new space property. This is the same as POST /api/space/{spaceKey}/property but the key for the property is passed as a path parameter, rather than in the request body.

Permissions required: ‘Admin’ permission for the space.

App scope required: WRITE

OAuth scopes required: 
write:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space that the property will be created in.

key Required

string

The key of the property to be created.

Body parameters
value Required

PropertyValue

The value of the property. This can be empty or a complex object. For example,

1
2
3
4
5
"value": {
  "example1": "value",
  "example2": true,
  "example3": 123
}

Example

1
2
3
4
5
6
7
curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property/{key}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "value": {}
}'

Responses

Returned if the space property is created.

Content typeValue
application/json

SpaceProperty

Delete space property

DELETE /wiki/rest/api/space/{spaceKey}/property/{key}

Deletes a space property.

Permissions required: ‘Admin’ permission for the space.

App scope required: DELETE

OAuth scopes required: 
write:confluence-props

Request

Path parameters
spaceKey Required

string

The key of the space that the property is in.

key Required

string

The key of the property to be deleted.

Example

1
2
curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/property/{key}'

Responses

Returned if the space property is deleted.

Rate this page: