Atlassian Content States API

The Content States API from Atlassian — 8 operation(s) for content states.

Documentation GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /wiki/rest/api/content/{id}/state Get a page's content state · Atlassian Get Content State #

Ask an LLM

“What status label, like In progress or Ready for review, is on a Confluence page?”

“Can I check the content state of a page's draft rather than its published version?”

Tell an agent

Get the content state of page {id}.

Show the content state on the {status} version of content {id}.

PUT /wiki/rest/api/content/{id}/state Set the content state on a page · Atlassian Set The Content State Of A Content And Publishes A New Version Of The… #

Ask an LLM

“How do I mark a single Confluence page as Ready for review?”

“Can I create a custom content state with my own name and color while setting it on a page?”

Tell an agent

Set the content state of page {id} to {name} with color {color}.

Apply existing content state {state_id} to the {status} version of page {id}.

DELETE /wiki/rest/api/content/{id}/state Clear the content state from a page · Atlassian Removes The Content State Of A Content And Publishes A New Version #

Ask an LLM

“How do I remove the status label from one Confluence page?”

“Does clearing a page's content state create a new version?”

Tell an agent destructive · confirm first

Remove the content state from page {id}.

Clear the status label on the {status} version of content {id}.

GET /wiki/rest/api/content/{id}/state/available List content states available for a page · Atlassian Gets Available Content States For Content #

Ask an LLM

“Which status labels can I choose from for this particular page?”

“Why do I only see three custom content states for a page?”

Tell an agent

List the content states I can set on page {id}.

Show the space and recent custom states available for content {id}.

PUT /wiki/rest/api/content-states Set a content state on many pages at once · Atlassian Bulk Set Content State Of Many Contents #

Ask an LLM

“How do I mark a batch of Confluence pages as Verified in one go?”

“Is bulk-setting content states run as a long-running task?”

Tell an agent

Set content state {contentState} on the {status} versions of pages {ids}.

Start a bulk task applying state {contentState} to pages {ids} ({status} versions).

GET /wiki/rest/api/content-states List my custom content states · Atlassian Get Custom Content States #

Ask an LLM

“Which custom content states have I created in Confluence?”

“Can I see all of my own custom page statuses, not just the recent three?”

Tell an agent

List every custom content state I've created.

Show my personal custom page statuses.

POST /wiki/rest/api/content-states/delete Remove content states from many pages · Atlassian Bulk Remove Content States From Content #

Ask an LLM

“Can I clear status labels from a whole set of pages at once?”

“How do I bulk-remove content states from draft pages?”

Tell an agent destructive · confirm first

Remove content states from the {status} versions of pages {ids}.

Start a bulk task clearing page statuses on {ids}, {status} versions.

GET /wiki/rest/api/content-states/task/{taskId} Check a bulk content state task's progress · Atlassian Get Update On Long Running Task For Setting Of Content State #

Ask an LLM

“Has my bulk content state update finished yet?”

“What is the status of a long-running set or remove content states task?”

Tell an agent

Check the progress of content state task {taskId}.

Tell me whether bulk page status task {taskId} has completed.

GET /wiki/rest/api/space/{spaceKey}/state List suggested content states in a space · Atlassian Get Space Suggested Content States #

Ask an LLM

“Which page statuses does a Confluence space suggest to its authors?”

“What space-level content states are defined for my space?”

Tell an agent

List the suggested content states in space {spaceKey}.

Show the space content states configured for {spaceKey}.

GET /wiki/rest/api/space/{spaceKey}/state/settings Get a space's content state settings · Atlassian Get Content State Settings For Space #

Ask an LLM

“Are content states even allowed in this Confluence space?”

“Is a space restricting authors from using custom content states?”

Tell an agent

Get the content state settings for space {spaceKey}.

Check whether custom or space content states are restricted in {spaceKey}.

GET /wiki/rest/api/space/{spaceKey}/state/content Find pages in a space with a given content state · Atlassian Get Content In Space With Given Content State #

Ask an LLM

“Which pages in a space are currently marked In progress?”

“Can I page through all content that has a particular status label?”

Tell an agent

Find content in space {spaceKey} with content state {state_id}.

List up to {limit} pages in {spaceKey} carrying state {state_id}.

Atlassian Content States API

Operations 11

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification