Add Content Labels
-
Add Labels To A Specific Content Item In Confluence.
Add Content Restrictions
-
Adds Restrictions To A Piece Of Content. Note, This Does Not Change Any Existing Restrictions On The Content. Permission To Edit The Content Is Required.
Add Content Watcher
-
Adds A User As A Watcher To A Piece Of Content. Choose The User By Doing One Of The Following - Specify A User Via A Query Parameter (Use The AccountId To Identify The User), Do Not Specify A User (The Currently Logged-In User Will Be Used). Note, You Must Add The X-Atlassian-Token No-Check Header When Making A Request, As This Operation Has XSRF Protection. 'Confluence Administrator' Global Permission If Specifying A User, Otherwise Permission To Access The Confluence Site ('Can Use' Global Permission) Is Required.
Add Group To Content Restriction
-
Adds A Group To A Content Restriction By Group Id. That Is, Grant Read Or Update Permission To The Group For A Piece Of Content. Permission To Edit The Content Is Required.
Add Label Watcher
-
Adds A User As A Watcher To A Label. Choose The User By Doing One Of The Following - Specify A User Via A Query Parameter (Use The AccountId To Identify The User), Do Not Specify A User (The Currently Logged-In User Will Be Used). Note, You Must Add The X-Atlassian-Token No-Check Header When Making A Request, As This Operation Has XSRF Protection. 'Confluence Administrator' Global Permission If Specifying A User, Otherwise Permission To Access The Confluence Site ('Can Use' Global Permission) Is Required.
Add Labels To Content
-
Adds Labels To A Piece Of Content. Does Not Modify The Existing Labels. Labels Can Also Be Added When Creating Content Or Updated When Updating Content. Permission To Update The Content Is Required.
Add Member To Group
-
Adds A User As A Member In A Group Represented By Its GroupId
Add Space Watcher
-
Adds A User As A Watcher To A Space. Choose The User By Doing One Of The Following - Specify A User Via A Query Parameter (Use The AccountId To Identify The User), Do Not Specify A User (The Currently Logged-In User Will Be Used). Note, You Must Add The X-Atlassian-Token No-Check Header When Making A Request, As This Operation Has XSRF Protection. 'Confluence Administrator' Global Permission If Specifying A User, Otherwise Permission To Access The Confluence Site ('Can Use' Global Permission) Is Required.
Add User To Content Restriction
-
Adds A User To A Content Restriction. That Is, Grant Read Or Update Permission To The User For A Piece Of Content. Permission To Edit The Content Is Required.
Archive Pages
-
Archives A List Of Pages. The Pages To Be Archived Are Specified As A List Of Content IDs. This API Accepts The Archival Request And Returns A Task ID. The Archival Process Happens Asynchronously. Use The /Longtask/ REST API To Get The Copy Task Status. Each Content ID Needs To Resolve To Page Objects That Are Not Already In An Archived State. The Content IDs Need Not Belong To The Same Space.
Asynchronously Convert Content Body
-
Converts A Content Body From One Format To Another Format Asynchronously. Returns The AsyncId For The Asynchronous Task. Supported Conversions - Atlas_doc_format (Editor, Export_view, Storage, Styled_view, View), Storage (Atlas_doc_format, Editor, Export_view, Styled_view, View), Editor (Storage). No Other Conversions Are Supported At The Moment. Once A Conversion Is Completed, It Will Be Available For 5 Minutes At The Result Endpoint. If Request Specifies 'ContentIdContext', 'View' Permission For The Space, And Permission To View The Content Is Required.
Check Content Permissions
-
Check If A User Or A Group Can Perform An Operation To The Specified Content. The Operation To Check Must Be Provided. The User'S Account ID Or The ID Of The Group Can Be Provided In The Subject To Check Permissions Against A Specified User Or Group. The Following Permission Checks Are Done To Make Sure That The User Or Group Has The Proper Access - Site Permissions, Space Permissions, Content Restrictions. Permission To Access The Confluence Site ('Can Use' Global Permission) If Checking Permission For Self, Otherwise 'Confluence Administrator' Global Permission Is Required.
Copy Page Hierarchy
-
Copy Page Hierarchy Allows The Copying Of An Entire Hierarchy Of Pages And Their Associated Properties, Permissions And Attachments. The Id Path Parameter Refers To The Content Id Of The Page To Copy, And The New Parent Of This Copied Page Is Defined Using The DestinationPageId In The Request Body. The TitleOptions Object Defines The Rules Of Renaming Page Titles During The Copy. Use The /Longtask/ REST API To Get The Copy Task Status.
Copy Single Page
-
Copies A Single Page And Its Associated Properties, Permissions, Attachments, And Custom Contents. The Id Path Parameter Refers To The Content ID Of The Page To Copy. The Target Of The Page To Be Copied Is Defined Using The Destination In The Request Body And Can Be One Of The Following Types - 'Space' (Page Will Be Copied To The Specified Space As A Root Page On The Space), 'Parent_page' (Page Will Be Copied As A Child Of The Specified Parent Page), 'Parent_content' (Page Will Be Copied As A Child Of The Specified Parent Content), 'Existing_page' (Page Will Be Copied And Replace The Specified Page). By Default, The Following Objects Are Expanded (Space, History, Version). 'Add' Permission For The Space That The Content Will Be Copied In And Permission To Update The Content If Copying To An 'Existing_page' Is Required.
Create A Space Role
-
Create A Space Role. User Must Be An Organization Or Site Admin. Connect And Forge App Users Are Not Authorized To Access This Resource. Direct API Access Using OAuth 2.0 Or Basic Auth (Email + API Token) Is Supported For Admin Users.
Create Asynchronous Content Body Conversion Tasks In Bulk
-
Asynchronously Converts Content Bodies From One Format To Another Format In Bulk. Use The Content Body REST API To Get The Status Of Conversion Tasks. Note That There Is A Maximum Limit Of 10 Conversions Per Request To This Endpoint. Supported Conversions - Storage (Editor, Export_view, Styled_view, View), Editor (Storage). Once A Conversion Task Is Completed, It Is Available For Polling For Up To 5 Minutes. 'View' Permission For The Space, And Permission To View The Content If The SpaceKeyContext Or ContentIdContext Are Present Is Required.
Create Attachment
-
Adds An Attachment To A Piece Of Content. This Method Only Adds A New Attachment. If You Want To Update An Existing Attachment, Use Create Or Update Attachments. Note, You Must Set A X-Atlassian-Token Nocheck Header On The Request For This Method, Otherwise It Will Be Blocked. This Protects Against XSRF Attacks, Which Is Necessary As This Method Accepts Multipart/Form-Data. Permission To Update The Content Is Required.
Create Audit Record
-
Creates A Record In The Audit Log.
Create Blog Post
-
Creates A New Blog Post In The Space Specified By The SpaceId. By Default This Will Create The Blog Post As A Non-Draft, Unless The Status Is Specified As Draft. If Creating A Non-Draft, The Title Must Not Be Empty.
Create Content Property For Attachment
-
Creates A New Content Property For An Attachment.
Create Content Property For Blog Post
-
Creates A New Property For A Blogpost.
Create Content Property For Comment
-
Creates A New Content Property For A Comment.
Create Content Property For Custom Content
-
Creates A New Content Property For A Piece Of Custom Content.
Create Content Property For Database
-
Creates A New Content Property For A Database.
Create Content Property For Folder
-
Creates A New Content Property For A Folder.
Create Content Property For Page
-
Creates A New Content Property For A Page.
Create Content Property For Smart Link In The Content Tree
-
Creates A New Content Property For A Smart Link In The Content Tree.
Create Content Property For Whiteboard
-
Creates A New Content Property For A Whiteboard.
Create Content Template
-
Creates A New Content Template. Note, Blueprint Templates Cannot Be Created Via The REST API. 'Admin' Permission For The Space To Create A Space Template Or 'Confluence Administrator' Global Permission To Create A Global Template Is Required.
Create Custom Content
-
Creates A New Custom Content In The Given Space, Page, Blogpost Or Other Custom Content. Only One Of SpaceId, PageId, BlogPostId, Or CustomContentId Is Required In The Request Body.
Create Database
-
Creates A Database In The Space. Permission To View The Corresponding Space And Permission To Create A Database In The Space Is Required.
Create Folder
-
Creates A Folder In The Space. Permission To View The Corresponding Space And Permission To Create A Folder In The Space Is Required.
Create Footer Comment
-
Create A Footer Comment. The Footer Comment Can Be Made Against Several Locations - At The Top Level (Specifying PageId Or BlogPostId In The Request Body), As A Reply (Specifying ParentCommentId In The Request Body), Against An Attachment, Or Against A Custom Content.
Create Group
-
Creates A New User Group.
Create Or Update A Forge App Property.
-
Creates Or Updates A Forge App Property. This API Can Only Be Accessed Using AsApp() Requests From Forge. Regular API Calls With Bearer Tokens Will Return 401 Unauthorized. This Endpoint Requires OAuth 2.0 Scope Read:App-Data:Confluence And Can Only Be Used Within Forge App Context.
Create Or Update Attachment
-
Adds An Attachment To A Piece Of Content. If The Attachment Already Exists For The Content, Then The Attachment Is Updated (I.E. A New Version Of The Attachment Is Created). Note, You Must Set A X-Atlassian-Token Nocheck Header On The Request For This Method, Otherwise It Will Be Blocked. This Protects Against XSRF Attacks, Which Is Necessary As This Method Accepts Multipart/Form-Data. Permission To Update The Content Is Required.
Create Page
-
Creates A Page In The Space. Pages Are Created As Published By Default Unless Specified As A Draft In The Status Field. If Creating A Published Page, The Title Must Be Specified.
Create Smart Link In The Content Tree
-
Creates A Smart Link In The Content Tree In The Space. Permission To View The Corresponding Space. Permission To Create A Smart Link In The Content Tree In The Space.
Create Space
-
Creates A Space As Specified In The Payload.
Create Space Property In Space
-
Creates A New Space Property.
Create User Property
-
Creates A Property For A User. These Properties Stored Against A User Are On A Confluence Site Level And Not Space Or Content Level. Note, The Number Of Properties Which Could Be Created Per App In A Tenant For Each User Might Be Restricted By Fixed System Limits. Permission To Access The Confluence Site Is Required.
Create Whiteboard
-
Creates A Whiteboard In The Space. Permission To View The Corresponding Space. Permission To Create A Whiteboard In The Space.
Delete A Space Role
-
Delete A Space Role. User Must Be An Organization Or Site Admin. Connect And Forge App Users Are Not Authorized To Access This Resource. Direct API Access Using OAuth 2.0 Or Basic Auth (Email + API Token) Is Supported For Admin Users.
Delete Attachment
-
Delete An Attachment By Id. Deleting An Attachment Moves The Attachment To The Trash, Where It Can Be Restored Later. To Permanently Delete An Attachment (Or Purge It), The Endpoint Must Be Called On A Trashed Attachment With The Following Param Purge=True.
Delete Blog Post
-
Delete A Blog Post By Id. By Default This Will Delete Blog Posts That Are Non-Drafts. To Delete A Blog Post That Is A Draft, The Endpoint Must Be Called On A Draft With The Following Param Draft=True. Discarded Drafts Are Not Sent To The Trash And Are Permanently Deleted. Deleting A Blog Post That Is Not A Draft Moves The Blog Post To The Trash, Where It Can Be Restored Later. To Permanently Delete A Blog Post (Or Purge It), The Endpoint Must Be Called On A Trashed Blog Post With The Following Param Purge=True.
Delete Content Property For Attachment By Id
-
Deletes A Content Property For An Attachment By Its Id.
Delete Content Property For Blogpost By Id
-
Deletes A Content Property For A Blogpost By Its Id.
Delete Content Property For Comment By Id
-
Deletes A Content Property For A Comment By Its Id.
Delete Content Property For Custom Content By Id
-
Deletes A Content Property For A Piece Of Custom Content By Its Id.
Delete Content Property For Database By Id
-
Deletes A Content Property For A Database By Its Id.
Delete Content Property For Folder By Id
-
Deletes A Content Property For A Folder By Its Id.
Delete Content Property For Page By Id
-
Deletes A Content Property For A Page By Its Id.
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.
Delete Content Property For Whiteboard By Id
-
Deletes A Content Property For A Whiteboard By Its Id.
Delete Content Restrictions
-
Removes All Restrictions (Read And Update) On A Piece Of Content. Permission To Edit The Content Is Required.
Delete Content Version
-
Delete A Historical Version. This Does Not Delete The Changes Made To The Content In That Version, Rather The Changes For The Deleted Version Are Rolled Up Into The Next Version. Note, You Cannot Delete The Current Version. Permission To Update The Content Is Required.
Delete Custom Content
-
Delete A Custom Content By Id. Deleting A Custom Content Will Either Move It To The Trash Or Permanently Delete It (Purge It), Depending On The ApiSupport. To Permanently Delete A Trashed Custom Content, The Endpoint Must Be Called With The Following Param Purge=True.
Delete Database
-
Delete A Database By Id. Deleting A Database Moves The Database To The Trash, Where It Can Be Restored Later. Permission To View The Database And Its Corresponding Space, And Permission To Delete Databases In The Space Is Required.
Delete Folder
-
Delete A Folder By Id. Deleting A Folder Moves The Folder To The Trash, Where It Can Be Restored Later. Permission To View The Folder And Its Corresponding Space, And Permission To Delete Folders In The Space Is Required.
Delete Footer Comment
-
Deletes A Footer Comment. This Is A Permanent Deletion And Cannot Be Reverted.
Delete Group
-
Delete User Group.
Delete Inline Comment
-
Deletes An Inline Comment. This Is A Permanent Deletion And Cannot Be Reverted.
Delete Page
-
Delete A Page By Id. By Default This Will Delete Pages That Are Non-Drafts. To Delete A Page That Is A Draft, The Endpoint Must Be Called On A Draft With The Following Param Draft=True. Discarded Drafts Are Not Sent To The Trash And Are Permanently Deleted. Deleting A Page Moves The Page To The Trash, Where It Can Be Restored Later. To Permanently Delete A Page (Or Purge It), The Endpoint Must Be Called On A Trashed Page With The Following Param Purge=True.
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. 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.
Delete Space Default Classification Level
-
Delete The Default Classification Level For A Specific Space.
Delete Space Property By Id
-
Deletes A Space Property By Its Id.
Delete User Property
-
Deletes A Property For The Given User. These Properties Stored Against A User Are On A Confluence Site Level And Not Space Or Content Level. Permission To Access The Confluence Site Is Required.
Delete Whiteboard
-
Delete A Whiteboard By Id. Deleting A Whiteboard Moves The Whiteboard To The Trash, Where It Can Be Restored Later. Permission To View The Whiteboard And Its Corresponding Space. Permission To Delete Whiteboards In The Space.
Deletes A Forge App Property.
-
Deletes A Forge App Property. This API Can Only Be Accessed Using AsApp() Requests From Forge. Regular API Calls With Bearer Tokens Will Return 401 Unauthorized. This Endpoint Requires OAuth 2.0 Scope Read:App-Data:Confluence And Can Only Be Used Within Forge App Context.
Disable Admin Key
-
Disables Admin Key Access For The Calling User Within The Site. User Must Be An Organization Or Site Admin.
Enable Admin Key
-
Enables Admin Key Access For The Calling User Within The Site. If An Admin Key Already Exists For The User, A New One Will Be Issued With An Updated Expiration Time. Note, The DurationInMinutes Field Within The Request Body Is Optional. If The Request Body Is Empty Or If The DurationInMinutes Is Set To 0 Minutes, A New Admin Key Will Be Issued To The Calling User With A Default Duration Of 10 Minutes. User Must Be An Organization Or Site Admin.
Export Audit Records
-
Exports Audit Records As A CSV File Or ZIP File.
Get A Forge App Property By Key.
-
Gets A Forge App Property By Property Key. This API Can Only Be Accessed Using AsApp() Requests From Forge. Regular API Calls With Bearer Tokens Will Return 401 Unauthorized. This Endpoint Requires OAuth 2.0 Scope Read:App-Data:Confluence And Can Only Be Used Within Forge App Context.
Get Account IDs Of Likes For Blog Post
-
Returns The Account IDs Of Likes Of Specific Blog Post.
Get Account IDs Of Likes For Footer Comment
-
Returns The Account IDs Of Likes Of Specific Footer Comment.
Get Account IDs Of Likes For Inline Comment
-
Returns The Account IDs Of Likes Of Specific Inline Comment.
Get Account IDs Of Likes For Page
-
Returns The Account IDs Of Likes Of Specific Page.
Get Admin Key
-
Returns Information About The Admin Key If One Is Currently Enabled For The Calling User Within The Site. User Must Be An Organization Or Site Admin.
Get All Ancestors Of Database
-
Returns All Ancestors For A Given Database By ID In Top-To-Bottom Order (That Is, The Highest Ancestor Is The First Item In The Response Payload). The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available By Calling This Endpoint With The ID Of First Ancestor In The Response Payload. This Endpoint Returns Minimal Information About Each Ancestor. To Fetch More Details, Use A Related Endpoint, Such As Get Database By Id.
Get All Ancestors Of Folder
-
Returns All Ancestors For A Given Folder By ID In Top-To-Bottom Order (That Is, The Highest Ancestor Is The First Item In The Response Payload). The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available By Calling This Endpoint With The ID Of First Ancestor In The Response Payload. This Endpoint Returns Minimal Information About Each Ancestor. To Fetch More Details, Use A Related Endpoint, Such As Get Folder By Id.
Get All Ancestors Of Page
-
Returns All Ancestors For A Given Page By ID In Top-To-Bottom Order (That Is, The Highest Ancestor Is The First Item In The Response Payload). The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available By Calling This Endpoint With The ID Of First Ancestor In The Response Payload. This Endpoint Returns Minimal Information About Each Ancestor. To Fetch More Details, Use A Related Endpoint, Such As Get Page By Id.
Get All Ancestors Of Smart Link In Content Tree
-
Returns All Ancestors For A Given Smart Link In The Content Tree By ID In Top-To-Bottom Order (That Is, The Highest Ancestor Is The First Item In The Response Payload). The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available By Calling This Endpoint With The ID Of First Ancestor In The Response Payload. This Endpoint Returns Minimal Information About Each Ancestor. To Fetch More Details, Use A Related Endpoint, Such As Get Smart Link In The Content Tree By Id.
Get All Ancestors Of Whiteboard
-
Returns All Ancestors For A Given Whiteboard By ID In Top-To-Bottom Order (That Is, The Highest Ancestor Is The First Item In The Response Payload). The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available By Calling This Endpoint With The ID Of First Ancestor In The Response Payload. This Endpoint Returns Minimal Information About Each Ancestor. To Fetch More Details, Use A Related Endpoint, Such As Get Whiteboard By Id.
Get Anonymous User
-
Returns Information About How Anonymous Users Are Represented, Like The Profile Picture And Display Name.
Get Asynchronous Content Body Conversion Task Results In Bulk
-
Returns The Content Body For The Corresponding AsyncId Of A Completed Conversion Task. If The Task Is Not Completed, The Task Status Is Returned Instead. Once A Conversion Task Is Completed, The Result Can Be Obtained For Up To 5 Minutes, Or Until An Identical Conversion Request Is Made Again With The AllowCache Parameter Set To False. Note That There Is A Maximum Limit Of 50 Task Results Per Request To This Endpoint. Permission To Access The Confluence Site ('Can Use' Global Permission) Is Required.
Get Asynchronously Converted Content Body
-
Returns The Asynchronous Content Body For The Corresponding Id If The Task Is Complete Or Returns The Status Of The Task. After The Task Is Completed, The Result Can Be Obtained For 5 Minutes, Or Until An Identical Conversion Request Is Made Again, With AllowCache Query Param Set To False. If Request Specifies 'ContentIdContext', 'View' Permission For The Space, And Permission To View The Content Is Required.
Get Attachment By Id
-
Returns A Specific Attachment.
Get Attachment Comments
-
Returns The Comments Of The Specific Attachment. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachment Labels
-
Returns The Labels Of Specific Attachment. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachments
-
Returns All Attachments. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachments For Blog Post
-
Returns The Attachments Of Specific Blog Post. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachments For Custom Content
-
Returns The Attachments Of Specific Custom Content. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachments For Label
-
Returns The Attachments Of Specified Label. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Attachments For Page
-
Returns The Attachments Of Specific Page. The Number Of Results Is Limited By The Limit Parameter And Additional Results (If Available) Will Be Available Through The Next URL Present In The Link Response Header.
Get Audit Records
-
Returns All Records In The Audit Log, Optionally For A Certain Date Range. This Contains Information About Events Like Space Exports, Group Membership Changes, App Installations, Etc.
Get Audit Records For Time Period
-
Returns Records From The Audit Log, For A Time Period Back From The Current Date. For Example, You Can Use This Method To Get The Last 3 Months Of Records. This Contains Information About Events Like Space Exports, Group Membership Changes, App Installations, Etc.
Get Available Content States
-
Gets Content States That Are Available For The Content To Be Set As. Will Return All Enabled Space Content States. Will Only Return Most The 3 Most Recently Published Custom Content States To Match UI Editor List. To Get All Custom Content States, Use The /Content-States Endpoint. Permission To Edit The Content Is Required.
Get Available Space Permissions
-
Retrieves The Available Space Permissions.
Get Available Space Roles
-
Retrieves The Available Space Roles.
Get Blog Post By Id
-
Returns A Specific Blog Post.