ConfluenceSoapService (Atlassian Confluence 5.8.9 API)

All Superinterfaces:

SecureRpc

All Known Implementing Classes:

WikiSoapService, XhtmlSoapService
```
public interface ConfluenceSoapService
extends SecureRpc
```

Field Summary

Fields
Modifier and Type Field and Description

static String ADMIN_SPACE_PERMISSION

static String COMMENT_PERMISSION

static String MODIFY_PERMISSION

static String VIEW_PERMISSION

Fields
Modifier and Type	Field and Description
`static String`	`ADMIN_SPACE_PERMISSION`
`static String`	`COMMENT_PERMISSION`
`static String`	`MODIFY_PERMISSION`
`static String`	`VIEW_PERMISSION`

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`boolean`	`addAnonymousPermissionsToSpace(String token, String[] permissions, String spaceKey)` Add Space Permissions for anonymous users
`boolean`	`addAnonymousPermissionToSpace(String token, String permission, String spaceKey)` Add a Space Permission for anonymous users
`boolean`	`addAnonymousUsePermission(String token)`
`boolean`	`addAnonymousViewUserProfilePermission(String token)` This permission can only be set if the anonymous user already has 'use' permission.
`RemoteAttachment`	`addAttachment(String token, long contentId, RemoteAttachment attachment, byte[] attachmentData)` Add a new attachment to a ContentEntityObject.
`RemoteAttachment`	`addAttachment(String token, RemoteAttachment attachment, byte[] attachmentData)` Deprecated. since 2.7. Use `addAttachment(String, long, com.atlassian.confluence.rpc.soap.beans.RemoteAttachment, byte[])`
`RemoteComment`	`addComment(String token, RemoteComment comment)` Adds a comment to a page or blog post
`boolean`	`addGlobalPermission(String token, String permission, String remoteEntityName)` Add global permissions for a user or group
`boolean`	`addGlobalPermissions(String token, String[] permissions, String remoteEntityName)` Add a global permission for a user or group
`boolean`	`addGroup(String token, String groupname)` Adds a new group
`boolean`	`addLabelById(String token, long labelId, long objectId)` Adds a label with the given ID to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByName(String token, String labelName, long objectId)` Adds a label to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByNameToSpace(String token, String labelName, String spaceKey)` Adds a label to the object with the given ContentEntityObject ID.
`boolean`	`addLabelByObject(String token, RemoteLabel labelObject, long objectId)` Adds the given label object to the object with the given ContentEntityObject ID.
`boolean`	`addPermissionsToSpace(String token, String[] permissions, String remoteEntityName, String spaceKey)` Add Space Permissions for a user or group
`boolean`	`addPermissionToSpace(String token, String permission, String remoteEntityName, String spaceKey)` Add a Space Permission for a user or group
`RemoteSpace`	`addPersonalSpace(String token, RemoteSpace space, String username)`
`RemoteSpace`	`addPersonalSpaceWithDefaultPermissions(String token, RemoteSpace space, String username)`
`boolean`	`addProfilePicture(String token, String userName, String fileName, String mimeType, byte[] pictureData)` Add a profile picture to a user's profile
`RemoteSpace`	`addSpace(String token, RemoteSpace space)`
`RemoteSpaceGroup`	`addSpaceGroup(String token, RemoteSpaceGroup spaceGroup)` Add a space Group to Confluence
`RemoteSpace`	`addSpaceWithDefaultPermissions(String token, RemoteSpace space)`
`void`	`addUser(String token, RemoteUser remoteUser, String password)` Adds a user with the given RemoteUser object and password
`void`	`addUser(String token, RemoteUser remoteUser, String password, boolean notifyUser)` Adds a user with the given RemoteUser object and password
`boolean`	`addUserToGroup(String token, String username, String groupname)`
`boolean`	`changeMyPassword(String token, String oldPass, String newPass)` Change the current user's password
`boolean`	`changeUserPassword(String token, String username, String newPass)` Change a user's password
`boolean`	`clearIndexQueue(String token)`
`String`	`convertWikiToStorageFormat(String token, String markup)` Converts a string from wiki markup to the XHTML based storage format.
`boolean`	`deactivateUser(String token, String username)` Deactivates the given user
`RemoteComment`	`editComment(String token, RemoteComment comment)` Updates a comment
`boolean`	`editUser(String token, RemoteUser remoteUser)` Edits a user with the values in the given RemoteUser object Currently this will only update the user's full name and email
`Boolean`	`emptyTrash(String token, String spaceKey)`
`String`	`exportSite(String token, boolean exportAttachments)`
`String`	`exportSpace(String token, String spaceKey, String exportType)`
`String`	`exportSpace(String token, String spaceKey, String exportType, boolean exportAll)`
`boolean`	`flushIndexQueue(String token)`
`String[]`	`getActiveUsers(String token, boolean viewAll)` Returns a list of the current system users
`RemotePageSummary[]`	`getAncestors(String token, long pageId)` Returns all direct ancestor pages of the page with the given pageId the user authenticated by token is allowed to view.
`RemoteAttachment`	`getAttachment(String token, long contentId, String fileName, int version)` Retrieve information about an attachment.
`byte[]`	`getAttachmentData(String token, long contentId, String fileName, int version)` Retrieve the contents of an attachment.
`RemoteAttachment[]`	`getAttachments(String token, long pageId)`
`RemoteBlogEntrySummary[]`	`getBlogEntries(String token, String spaceKey)`
`RemoteBlogEntry`	`getBlogEntry(String token, long entryId)`
`RemoteBlogEntry`	`getBlogEntryByDateAndTitle(String token, String spaceKey, int year, int month, int dayOfMonth, String postTitle)` Retrieves a blog post in the given space, with the title and date as specified.
`RemoteBlogEntry`	`getBlogEntryByDayAndTitle(String token, String spaceKey, int dayOfMonth, String postTitle)` Retrieves a blog post in the Space with the given spaceKey, with the title 'postTitle' and posted on the day 'dayOfMonth'
`RemotePageSummary[]`	`getChildren(String token, long pageId)` Returns all child pages of the page with the given pageId the user authenticated by token is allowed to view.
`RemoteClusterInformation`	`getClusterInformation(String token)`
`RemoteNodeStatus[]`	`getClusterNodeStatuses(String token)`
`RemoteComment`	`getComment(String token, long commentId)` Retrieves a comment with the given ID
`RemoteComment[]`	`getComments(String token, long pageId)` Retrieves the comments for a given abstract page
`RemoteContentPermissionSet`	`getContentPermissionSet(String token, long contentId, String permissionType)` Get the content permission set of a certain type for a particular piece of content
`RemoteContentPermissionSet[]`	`getContentPermissionSets(String token, long contentId)` Get the content permission sets for a particular piece of content
`RemotePageSummary[]`	`getDescendents(String token, long pageId)` Returns all descendent pages of the page with the given pageId the user authenticated by token is allowed to view.
`String[]`	`getGroups(String token)` Retrieves a list of user groups
`RemoteSearchResult[]`	`getLabelContentById(String token, long labelId)` Returns the content for a given label ID
`RemoteSearchResult[]`	`getLabelContentByName(String token, String labelName)` Returns the content for a given label name
`RemoteSearchResult[]`	`getLabelContentByObject(String token, RemoteLabel labelObject)` Returns the content for a given label object
`RemoteLabel[]`	`getLabelsByDetail(String token, String labelName, String namespace, String spaceKey, String owner)` Retrieves the labels matching the given labelName, namespace or owner.
`RemoteLabel[]`	`getLabelsById(String token, long objectId)` Returns all labels for the given ContentEntityObject ID.
`RemoteLabel[]`	`getMostPopularLabels(String token, int maxCount)` Returns the most popular labels for the Confluence instance, with a specified maximum number of results.
`RemoteLabel[]`	`getMostPopularLabelsInSpace(String token, String spaceKey, int maxCount)` Returns the most popular labels for the given spaceKey, with a specified maximum number of results.
`RemotePage`	`getPage(String token, long pageId)`
`RemotePage`	`getPage(String token, String spaceKey, String pageTitle)`
`RemotePageHistory[]`	`getPageHistory(String token, long pageId)`
`RemotePermission[]`	`getPagePermissions(String token, long pageId)`
`RemotePageSummary[]`	`getPages(String token, String spaceKey)` Returns all pages of the space with the given spaceKey the user authenticated by token is allowed to view.
`RemotePageSummary`	`getPageSummary(String token, long pageId)`
`RemotePageSummary`	`getPageSummary(String token, String spaceKey, String pageTitle)`
`String[]`	`getPermissions(String token, String spaceKey)`
`String[]`	`getPermissionsForUser(String token, String spaceKey, String userName)`
`RemoteLabel[]`	`getRecentlyUsedLabels(String token, int maxResults)` Returns the recently used labels for the Confluence instance, with a specified maximum number of results.
`RemoteLabel[]`	`getRecentlyUsedLabelsInSpace(String token, String spaceKey, int maxResults)` Returns the recently used labels for the given spaceKey, with a specified maximum number of results.
`RemoteLabel[]`	`getRelatedLabels(String token, String labelName, int maxResults)` Returns the labels related to the given label name, with a specified maximum number of results.
`RemoteLabel[]`	`getRelatedLabelsInSpace(String token, String labelName, String spaceKey, int maxResults)` Returns the labels related to the given label name for the given spaceKey, with a specified maximum number of results.
`RemoteServerInfo`	`getServerInfo(String token)`
`RemoteSpace`	`getSpace(String token, String spaceKey)`
`RemoteSpaceGroup`	`getSpaceGroup(String token, String spaceGroup)`
`RemoteSpaceGroup[]`	`getSpaceGroups(String token)`
`String[]`	`getSpaceLevelPermissions(String token)`
`RemoteSpacePermissionSet`	`getSpacePermissionSet(String token, String spaceKey, String permissionType)`
`RemoteSpacePermissionSet[]`	`getSpacePermissionSets(String token, String spaceKey)`
`RemoteSpaceSummary[]`	`getSpaces(String token)`
`RemoteSpace[]`	`getSpacesContainingContentWithLabel(String token, String labelName)` Returns all Spaces that have content labelled with labelName
`RemoteSpaceSummary[]`	`getSpacesInGroup(String token, String spaceGroupKey)`
`String`	`getSpaceStatus(String token, String spaceKey)`
`RemoteSpace[]`	`getSpacesWithLabel(String token, String labelName)` Returns an array of Spaces that have been labelled with labelName
`RemotePageSummary[]`	`getTopLevelPages(String token, String spaceKey)` Returns all top level pages of the space with the given spaceKey the user authenticated by token is allowed to view.
`RemoteContentSummaries`	`getTrashContents(String token, String spaceKey, int offset, int count)`
`RemoteUser`	`getUser(String token, String username)` Deprecated. since 5.2. Use `getUserByName(String, String)` instead.
`RemoteConfluenceUser`	`getUserByKey(String token, String userKey)` Retrieves a user with the given user key.
`RemoteConfluenceUser`	`getUserByName(String token, String username)` Retrieves a user with the given username.
`String[]`	`getUserGroups(String token, String username)` Retrieves the groups that a given user belongs to
`RemoteUserInformation`	`getUserInformation(String token, String username)` Retrieves a user's information
`boolean`	`getUserPreferenceBoolean(String token, String username, String key)` Get a user preference as a boolean value.
`long`	`getUserPreferenceLong(String token, String username, String key)` Get a user preference as a long integer value.
`String`	`getUserPreferenceString(String token, String username, String key)` Get a user preference as a String value.
`RemoteUser[]`	`getWatchersForPage(String token, long pageId)` Returns the list of users watching the page or blog post with the given ID.
`RemoteUser[]`	`getWatchersForSpace(String token, String spaceKey)` Returns the list of users watching the space with the given key.
`boolean`	`hasGroup(String token, String groupname)` Determines whether a group exists
`boolean`	`hasUser(String token, String username)` Determines whether a user exists
`boolean`	`importSpace(String token, byte[] importData)` Import a space in a compressed XML format
`boolean`	`installPlugin(String token, String pluginFileName, byte[] pluginData)` Installs a plugin.
`boolean`	`isActiveUser(String token, String username)` Checks if a given user is active.
`boolean`	`isDarkFeatureEnabled(String token, String key)`
`boolean`	`isPluginEnabled(String token, String pluginKey)` Returns true if the specified plugin is enabled.
`boolean`	`isPluginInstalled(String token, String pluginKey)` Returns true if the specified plugin is installed.
`boolean`	`isWatchingPage(String token, long pageId, String username)` Returns true if the specified user is watching the page or blog post with the given ID, otherwise false.
`boolean`	`isWatchingSpace(String token, String spaceKey, String username)` Returns true if the specified user is watching the space with the given key, otherwise false.
`boolean`	`isWatchingSpaceForType(String token, String spaceKey, String contentType, String username)` Returns true if the specified user is watching the specified type of content in space with the given key, otherwise false.
`String`	`login(String username, String password)`
`boolean`	`logout(String token)`
`boolean`	`moveAttachment(String token, long originalContentId, String originalFileName, long newContentId, String newFileName)` Move or rename an attachment
`Boolean`	`movePage(String token, long sourcePageId, long targetPageId, String position)`
`Boolean`	`movePageToTopLevel(String token, long pageId, String targetSpaceKey)`
`String`	`performBackup(String token, boolean exportAttachments)`
`Boolean`	`purgeFromTrash(String token, String spaceKey, long pageId)`
`boolean`	`reactivateUser(String token, String username)` Reactivates the given user
`boolean`	`recoverMainIndex(String token)`
`boolean`	`removeAllPermissionsForGroup(String token, String groupname)` Deletes all global and space permissions for the given group
`boolean`	`removeAnonymousPermissionFromSpace(String token, String permission, String spaceKey)` Removes a Space Permission for anonymous users
`boolean`	`removeAnonymousUsePermission(String token)` Remove anonymous use permission.
`boolean`	`removeAnonymousViewUserProfilePermission(String token)`
`boolean`	`removeAttachment(String token, long contentId, String fileName)` Remove an attachment.
`boolean`	`removeComment(String token, long commentId)` Removes a comment with the given ID
`boolean`	`removeGlobalPermission(String token, String permission, String remoteEntityName)` Remove a global permission
`boolean`	`removeGroup(String token, String groupname, String defaultGroupName)` Removes an existing group If a valid defaultGroupName is specified, users will be added to the new group (defaultGroupName).
`boolean`	`removeLabelById(String token, long labelId, long objectId)` Removes the label with the given ID from the object with the given ContentEntityObject ID.
`boolean`	`removeLabelByName(String token, String labelName, long objectId)` Removes the given label from the object with the given ContentEntityObject ID.
`boolean`	`removeLabelByNameFromSpace(String token, String labelName, String spaceKey)` Removes the given label from the given Space
`boolean`	`removeLabelByObject(String token, RemoteLabel labelObject, long objectId)` Removes the given label object from the object with the given ContentEntityObject ID.
`Boolean`	`removePage(String token, long pageId)`
`Boolean`	`removePageVersionById(String token, long historicalPageId)` Remove a historical version of a page.
`Boolean`	`removePageVersionByVersion(String token, long pageId, int version)` Remove the identified version of a page.
`boolean`	`removePageWatch(String token, long pageId)` Remove a watch for the current user on the page or blog post with the specified page ID.
`boolean`	`removePageWatchForUser(String token, long pageId, String username)` Removes a watch from a specific page or blog post for a particular user.
`boolean`	`removePermissionFromSpace(String token, String permission, String remoteEntityName, String spaceKey)` Removes a Space Permission for a user or group
`Boolean`	`removeSpace(String token, String spaceKey)`
`boolean`	`removeSpaceGroup(String token, String spaceGroupKey)` Removes a Space Group from Confluence without removeing the space it contains.
`boolean`	`removeSpaceWatch(String token, String spaceKey)` Removes a watch for the current user on the space with the specified space key.
`boolean`	`removeUser(String token, String username)` Removes a user with the given username
`boolean`	`removeUserFromGroup(String token, String username, String groupname)` Removes the given user from a group
`boolean`	`renameUser(String token, String oldUsername, String newUsername)` Change user's username
`String[]`	`renameUsers(String token, Map<String,String> oldUsernamesToNewUsernames)` Change usernames for a set of users
`String`	`renderContent(String token, String spaceKey, long pageId, String newContent)`
`String`	`renderContent(String token, String spaceKey, long pageId, String newContent, Map renderParameters)`
`RemoteSearchResult[]`	`search(String token, String query, int maxResults)` Search Confluence for the supplied query String.
`RemoteSearchResult[]`	`search(String token, String query, Map params, int maxResults)` Search Confluence for the supplied query String.
`boolean`	`setContentPermissions(String token, long contentId, String permissionType, RemoteContentPermission[] remoteContentPermissions)` Set the content permissions for a particular permission type on some content.
`boolean`	`setEnableAnonymousAccess(String token, boolean value)`
`boolean`	`setEnableWysiwyg(String token, boolean value)` Deprecated. since 4.0. You can no longer disable the wysiwyg editor.
`Boolean`	`setSpaceStatus(String token, String spaceKey, String status)`
`boolean`	`setUserInformation(String token, RemoteUserInformation userInfo)` Updates a user's information Currently this will only update a user's "description", stored in the 'content' attribute
`boolean`	`setUserPreferenceBoolean(String token, String username, String key, boolean value)` Set a user preference to a boolean value.
`boolean`	`setUserPreferenceLong(String token, String username, String key, long value)` Set a user preference to an long integer value.
`boolean`	`setUserPreferenceString(String token, String username, String key, String value)` Set a user preference to a String value.
`RemoteBlogEntry`	`storeBlogEntry(String token, RemoteBlogEntry blogEntry)`
`RemotePage`	`storePage(String token, RemotePage page)`
`RemoteSpace`	`storeSpace(String token, RemoteSpace remoteSpace)` Allows for modifying space details via the remote API.
`RemotePage`	`updatePage(String token, RemotePage page, RemotePageUpdateOptions options)`
`boolean`	`watchPage(String token, long pageId)` Adds a watch for the current user on the page or blog post with the specified page ID.
`boolean`	`watchPageForUser(String token, long pageId, String username)` Adds a watch to a specific page or blog post for a particular user.
`boolean`	`watchSpace(String token, String spaceKey)` Adds a watch for the current user on the space with the specified space key.

- Field Detail
  - VIEW_PERMISSION
```
static final String VIEW_PERMISSION
```
    See Also:
    
    Constant Field Values
  - MODIFY_PERMISSION
```
static final String MODIFY_PERMISSION
```
    See Also:
    
    Constant Field Values
  - COMMENT_PERMISSION
```
static final String COMMENT_PERMISSION
```
    See Also:
    
    Constant Field Values
  - ADMIN_SPACE_PERMISSION
```
static final String ADMIN_SPACE_PERMISSION
```
    See Also:
    
    Constant Field Values
- Method Detail
  - login
```
String login(String username,
             String password)
      throws AuthenticationFailedException,
             RemoteException
```
    Specified by:
    
    login in interface SecureRpc
    
    Throws:
    
    AuthenticationFailedException
    
    RemoteException
  - logout
```
boolean logout(String token)
        throws RemoteException
```
    Specified by:
    
    logout in interface SecureRpc
    
    Throws:
    
    RemoteException
  - getSpaces
```
RemoteSpaceSummary[] getSpaces(String token)
                        throws InvalidSessionException,
                               RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getSpacesInGroup
```
RemoteSpaceSummary[] getSpacesInGroup(String token,
                                      String spaceGroupKey)
                               throws RemoteException
```
    Throws:
    
    RemoteException
  - addSpaceWithDefaultPermissions
```
RemoteSpace addSpaceWithDefaultPermissions(String token,
                                           RemoteSpace space)
                                    throws NotPermittedException,
                                           InvalidSessionException,
                                           AlreadyExistsException,
                                           RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    AlreadyExistsException
    
    RemoteException
  - addSpace
```
RemoteSpace addSpace(String token,
                     RemoteSpace space)
              throws NotPermittedException,
                     InvalidSessionException,
                     AlreadyExistsException,
                     RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    AlreadyExistsException
    
    RemoteException
  - storeSpace
```
RemoteSpace storeSpace(String token,
                       RemoteSpace remoteSpace)
                throws RemoteException
```
    Allows for modifying space details via the remote API. Currently you can update the following space properties:
    - Name
    - Homepage
    - SpaceGroup
    Parameters:
    
    remoteSpace -
    
    Returns:
    
    Throws:
    
    RemoteException
  - addSpaceGroup
```
RemoteSpaceGroup addSpaceGroup(String token,
                               RemoteSpaceGroup spaceGroup)
                        throws NotPermittedException,
                               InvalidSessionException,
                               AlreadyExistsException,
                               RemoteException
```
    Add a space Group to Confluence
    
    Parameters:
    
    token - the authentication token
    
    spaceGroup - the spacegroup to add
    
    Returns:
    
    Throws:
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    InvalidSessionException
    
    AlreadyExistsException - if a group with the same key already exists
    
    RemoteException
  - getSpaceGroup
```
RemoteSpaceGroup getSpaceGroup(String token,
                               String spaceGroup)
                        throws NotPermittedException,
                               InvalidSessionException,
                               AlreadyExistsException,
                               RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    AlreadyExistsException
    
    RemoteException
  - getSpaceGroups
```
RemoteSpaceGroup[] getSpaceGroups(String token)
                           throws InvalidSessionException,
                                  RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - removeSpaceGroup
```
boolean removeSpaceGroup(String token,
                         String spaceGroupKey)
                  throws RemoteException
```
    Removes a Space Group from Confluence without removeing the space it contains. Currently requires global administration rights
    
    Parameters:
    
    token - the authentication token
    
    spaceGroupKey - the id of the spacegroup to be removed
    
    Returns:
    
    Throws:
    
    RemoteException
  - addPersonalSpace
```
RemoteSpace addPersonalSpace(String token,
                             RemoteSpace space,
                             String username)
                      throws NotPermittedException,
                             InvalidSessionException,
                             AlreadyExistsException,
                             RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    AlreadyExistsException
    
    RemoteException
  - addPersonalSpaceWithDefaultPermissions
```
RemoteSpace addPersonalSpaceWithDefaultPermissions(String token,
                                                   RemoteSpace space,
                                                   String username)
                                            throws NotPermittedException,
                                                   InvalidSessionException,
                                                   AlreadyExistsException,
                                                   RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    AlreadyExistsException
    
    RemoteException
  - removeSpace
```
Boolean removeSpace(String token,
                    String spaceKey)
             throws NotPermittedException,
                    InvalidSessionException,
                    RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - getSpace
```
RemoteSpace getSpace(String token,
                     String spaceKey)
              throws InvalidSessionException,
                     RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getSpaceStatus
```
String getSpaceStatus(String token,
                      String spaceKey)
               throws NotPermittedException,
                      InvalidSessionException,
                      RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - setSpaceStatus
```
Boolean setSpaceStatus(String token,
                       String spaceKey,
                       String status)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - getPermissions
```
String[] getPermissions(String token,
                        String spaceKey)
                 throws InvalidSessionException,
                        RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPermissionsForUser
```
String[] getPermissionsForUser(String token,
                               String spaceKey,
                               String userName)
                        throws InvalidSessionException,
                               NotPermittedException,
                               RemoteException
```
    Throws:
    
    InvalidSessionException
    
    NotPermittedException
    
    RemoteException
  - getSpacePermissionSets
```
RemoteSpacePermissionSet[] getSpacePermissionSets(String token,
                                                  String spaceKey)
                                           throws InvalidSessionException,
                                                  NotPermittedException,
                                                  RemoteException
```
    Throws:
    
    InvalidSessionException
    
    NotPermittedException
    
    RemoteException
  - getSpacePermissionSet
```
RemoteSpacePermissionSet getSpacePermissionSet(String token,
                                               String spaceKey,
                                               String permissionType)
                                        throws InvalidSessionException,
                                               NotPermittedException,
                                               RemoteException
```
    Throws:
    
    InvalidSessionException
    
    NotPermittedException
    
    RemoteException
  - addPermissionToSpace
```
boolean addPermissionToSpace(String token,
                             String permission,
                             String remoteEntityName,
                             String spaceKey)
                      throws RemoteException
```
    Add a Space Permission for a user or group
    
    Parameters:
    
    token - the authentication token
    
    permission - the Space Permission to add
    
    remoteEntityName - the name of the user or group
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space Permission is null
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
  - addPermissionsToSpace
```
boolean addPermissionsToSpace(String token,
                              String[] permissions,
                              String remoteEntityName,
                              String spaceKey)
                       throws RemoteException
```
    Add Space Permissions for a user or group
    
    Parameters:
    
    token - the authentication token
    
    permissions - the Space Permissions to add
    
    remoteEntityName - the name of the user or group
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space Permissions array is null
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
    
    Since:
    
    2.0
  - removePermissionFromSpace
```
boolean removePermissionFromSpace(String token,
                                  String permission,
                                  String remoteEntityName,
                                  String spaceKey)
                           throws NotPermittedException,
                                  RemoteException
```
    Removes a Space Permission for a user or group
    
    Parameters:
    
    token - the authentication token
    
    permission - the Space Permission to remove
    
    remoteEntityName - the name of the user or group
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
  - addAnonymousPermissionToSpace
```
boolean addAnonymousPermissionToSpace(String token,
                                      String permission,
                                      String spaceKey)
                               throws RemoteException
```
    Add a Space Permission for anonymous users
    
    Parameters:
    
    token - the authentication token
    
    permission - the Space Permission to add
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space Permission is null
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
    
    Since:
    
    2.0
  - addAnonymousPermissionsToSpace
```
boolean addAnonymousPermissionsToSpace(String token,
                                       String[] permissions,
                                       String spaceKey)
                                throws RemoteException
```
    Add Space Permissions for anonymous users
    
    Parameters:
    
    token - the authentication token
    
    permissions - the Space Permissions to add
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space Permissions array is null
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
    
    Since:
    
    2.0
  - removeAnonymousPermissionFromSpace
```
boolean removeAnonymousPermissionFromSpace(String token,
                                           String permission,
                                           String spaceKey)
                                    throws NotPermittedException,
                                           RemoteException
```
    Removes a Space Permission for anonymous users
    
    Parameters:
    
    token - the authentication token
    
    permission - the Space Permission to remove
    
    spaceKey - the key of the Space affected by this action
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    RemoteException - if the Space does not exist
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException - if the remoteEntityName is null or does not match a user or group
    
    Since:
    
    2.0
  - getPagePermissions
```
RemotePermission[] getPagePermissions(String token,
                                      long pageId)
                               throws InvalidSessionException,
                                      RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getSpaceLevelPermissions
```
String[] getSpaceLevelPermissions(String token)
                           throws RemoteException
```
    Throws:
    
    RemoteException
  - getPages
```
RemotePageSummary[] getPages(String token,
                             String spaceKey)
                      throws InvalidSessionException,
                             RemoteException
```
    Returns all pages of the space with the given spaceKey the user authenticated by token is allowed to view. The result is not ordered.
    
    Parameters:
    
    token - the authentication token
    
    spaceKey - the key of the space which pages are to be returned
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPage
```
RemotePage getPage(String token,
                   String spaceKey,
                   String pageTitle)
            throws InvalidSessionException,
                   RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPageSummary
```
RemotePageSummary getPageSummary(String token,
                                 String spaceKey,
                                 String pageTitle)
                          throws InvalidSessionException,
                                 RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPage
```
RemotePage getPage(String token,
                   long pageId)
            throws InvalidSessionException,
                   RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPageSummary
```
RemotePageSummary getPageSummary(String token,
                                 long pageId)
                          throws InvalidSessionException,
                                 RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - storePage
```
RemotePage storePage(String token,
                     RemotePage page)
              throws VersionMismatchException,
                     NotPermittedException,
                     InvalidSessionException,
                     RemoteException
```
    Throws:
    
    VersionMismatchException
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - updatePage
```
RemotePage updatePage(String token,
                      RemotePage page,
                      RemotePageUpdateOptions options)
               throws VersionMismatchException,
                      NotPermittedException,
                      InvalidSessionException,
                      RemoteException
```
    Throws:
    
    VersionMismatchException
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - movePageToTopLevel
```
Boolean movePageToTopLevel(String token,
                           long pageId,
                           String targetSpaceKey)
                    throws RemoteException
```
    Throws:
    
    RemoteException
  - movePage
```
Boolean movePage(String token,
                 long sourcePageId,
                 long targetPageId,
                 String position)
          throws RemoteException
```
    Throws:
    
    RemoteException
  - removePage
```
Boolean removePage(String token,
                   long pageId)
            throws NotPermittedException,
                   InvalidSessionException,
                   RemoteException
```
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - removePageVersionById
```
Boolean removePageVersionById(String token,
                              long historicalPageId)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
```
    Remove a historical version of a page. The id supplied must identify a historical version of a page rather than the latest version of the page. If you want to remove the latest version of a page and its full version history then see removePage(String, long).
    
    Parameters:
    
    token -
    
    historicalPageId - the id of a historical version of a page
    
    Returns:
    
    true if successfully remove, otherwise false.
    
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - removePageVersionByVersion
```
Boolean removePageVersionByVersion(String token,
                                   long pageId,
                                   int version)
                            throws NotPermittedException,
                                   InvalidSessionException,
                                   RemoteException
```
    Remove the identified version of a page. The pageId must identify a current page.
    
    Parameters:
    
    token -
    
    pageId - the id of the page which you want to remove a version from.
    
    version - the version of the page to be removed (with 1 being the first).
    
    Returns:
    
    true if successful; otherwise false.
    
    Throws:
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - getTrashContents
```
RemoteContentSummaries getTrashContents(String token,
                                        String spaceKey,
                                        int offset,
                                        int count)
                                 throws RemoteException
```
    Throws:
    
    RemoteException
  - purgeFromTrash
```
Boolean purgeFromTrash(String token,
                       String spaceKey,
                       long pageId)
                throws RemoteException
```
    Throws:
    
    RemoteException
  - emptyTrash
```
Boolean emptyTrash(String token,
                   String spaceKey)
            throws RemoteException
```
    Throws:
    
    RemoteException
  - getTopLevelPages
```
RemotePageSummary[] getTopLevelPages(String token,
                                     String spaceKey)
                              throws RemoteException
```
    Returns all top level pages of the space with the given spaceKey the user authenticated by token is allowed to view. The result is ordered by child page order.
    
    Parameters:
    
    token - the authentication token
    
    spaceKey - the key of the space which pages are to be returned
    
    Throws:
    
    RemoteException
  - getAncestors
```
RemotePageSummary[] getAncestors(String token,
                                 long pageId)
                          throws InvalidSessionException,
                                 RemoteException
```
    Returns all direct ancestor pages of the page with the given pageId the user authenticated by token is allowed to view. The result is not ordered.
    
    Parameters:
    
    token - the authentication token
    
    pageId - the id of the page which child pages are to be returned
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getChildren
```
RemotePageSummary[] getChildren(String token,
                                long pageId)
                         throws InvalidSessionException,
                                RemoteException
```
    Returns all child pages of the page with the given pageId the user authenticated by token is allowed to view. The result is ordered by child page order.
    
    Parameters:
    
    token - the authentication token
    
    pageId - the id of the page which child pages are to be returned
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getDescendents
```
RemotePageSummary[] getDescendents(String token,
                                   long pageId)
                            throws InvalidSessionException,
                                   RemoteException
```
    Returns all descendent pages of the page with the given pageId the user authenticated by token is allowed to view. The result is not ordered.
    
    Parameters:
    
    token - the authentication token
    
    pageId - the id of the page which child pages are to be returned
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getAttachments
```
RemoteAttachment[] getAttachments(String token,
                                  long pageId)
                           throws InvalidSessionException,
                                  RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - getPageHistory
```
RemotePageHistory[] getPageHistory(String token,
                                   long pageId)
                            throws InvalidSessionException,
                                   RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - watchPage
```
boolean watchPage(String token,
                  long pageId)
           throws RemoteException
```
    Adds a watch for the current user on the page or blog post with the specified page ID.
    
    Returns:
    
    true if the watch was added, or false if it already exists
    
    Throws:
    
    RemoteException - if the watch could not be added
  - watchSpace
```
boolean watchSpace(String token,
                   String spaceKey)
            throws RemoteException
```
    Adds a watch for the current user on the space with the specified space key.
    
    Returns:
    
    true if the watch was added, or false if it already exists
    
    Throws:
    
    RemoteException - if the watch could not be added
  - watchPageForUser
```
boolean watchPageForUser(String token,
                         long pageId,
                         String username)
                  throws RemoteException
```
    Adds a watch to a specific page or blog post for a particular user. This is only permitted for administrators of the space containing the page or blog post.
    
    Returns:
    
    true if the watch was added, or false if it already exists
    
    Throws:
    
    RemoteException - if the watch could not be added, or the current user does not have permission to add it
  - removePageWatch
```
boolean removePageWatch(String token,
                        long pageId)
                 throws RemoteException
```
    Remove a watch for the current user on the page or blog post with the specified page ID.
    
    Returns:
    
    true if the watch was removed, or false if it doesn't exist
    
    Throws:
    
    RemoteException - if the watch could not be removed
  - removeSpaceWatch
```
boolean removeSpaceWatch(String token,
                         String spaceKey)
                  throws RemoteException
```
    Removes a watch for the current user on the space with the specified space key.
    
    Returns:
    
    true if the watch was remove, or false if it doesn't exist
    
    Throws:
    
    RemoteException - if the watch could not be removed
  - removePageWatchForUser
```
boolean removePageWatchForUser(String token,
                               long pageId,
                               String username)
                        throws RemoteException
```
    Removes a watch from a specific page or blog post for a particular user. This is only permitted for administrators of the space containing the page or blog post.
    
    Returns:
    
    true if the watch was removed, or false if it doesn't exist
    
    Throws:
    
    RemoteException - if the watch could not be removed, or the current user does not have permission to remove it
  - isWatchingPage
```
boolean isWatchingPage(String token,
                       long pageId,
                       String username)
                throws RemoteException
```
    Returns true if the specified user is watching the page or blog post with the given ID, otherwise false. This information is only available to administrators of the space containing the page or blog post, if the username is not the same as the current user's.
    
    Returns:
    
    true if the user is watching the page, otherwise false
    
    Throws:
    
    RemoteException - if the current user does not have permission to see the page or administer the space, or if the page or user does not exist
  - isWatchingSpace
```
boolean isWatchingSpace(String token,
                        String spaceKey,
                        String username)
                 throws RemoteException
```
    Returns true if the specified user is watching the space with the given key, otherwise false. This information is only available to administrators of the space if the username is not the same as the current user's.
    
    Returns:
    
    true if the user is watching the space, otherwise false
    
    Throws:
    
    RemoteException - if the current user does not have permission to administer the space, or if the user does not exist
  - isWatchingSpaceForType
```
boolean isWatchingSpaceForType(String token,
                               String spaceKey,
                               String contentType,
                               String username)
                        throws RemoteException
```
    Returns true if the specified user is watching the specified type of content in space with the given key, otherwise false. This information is only available to administrators of the space if the username is not the same as the current user's.
    Note that this method will return false if the user is watching the entire space and not just the given type.
    
    Returns:
    
    true if the user is watching the space for the type, otherwise false
    
    Throws:
    
    RemoteException - if the current user does not have permission to administer the space, or if the user does not exist
  - getWatchersForPage
```
RemoteUser[] getWatchersForPage(String token,
                                long pageId)
                         throws RemoteException
```
    Returns the list of users watching the page or blog post with the given ID. This information is only available to administrators of the space containing the page or blog post.
    
    Returns:
    
    the list of users watching the page
    
    Throws:
    
    RemoteException - if the current user does not have permission to see the page or administer the space, or if the page does not exist
  - getWatchersForSpace
```
RemoteUser[] getWatchersForSpace(String token,
                                 String spaceKey)
                          throws RemoteException
```
    Returns the list of users watching the space with the given key. This information is only available to administrators of the space.
    
    Returns:
    
    the list of users watching the space
    
    Throws:
    
    RemoteException - if the current user does not have permission to administer the space, or if the space does not exist
  - renderContent
```
String renderContent(String token,
                     String spaceKey,
                     long pageId,
                     String newContent)
              throws InvalidSessionException,
                     RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - renderContent
```
String renderContent(String token,
                     String spaceKey,
                     long pageId,
                     String newContent,
                     Map renderParameters)
              throws RemoteException
```
    Throws:
    
    RemoteException
  - convertWikiToStorageFormat
```
String convertWikiToStorageFormat(String token,
                                  String markup)
                           throws RemoteException
```
    Converts a string from wiki markup to the XHTML based storage format.
    
    Returns:
    
    a string converted to the storage format
    
    Throws:
    
    RemoteException
  - addAttachment
```
RemoteAttachment addAttachment(String token,
                               long contentId,
                               RemoteAttachment attachment,
                               byte[] attachmentData)
                        throws RemoteException
```
    Add a new attachment to a ContentEntityObject.
    
    Parameters:
    
    token - the authentication token
    
    contentId - the id of the ContentEntityObject to receive the new attachment.
    
    attachment - RemoteAttachment object containing attachment information
    
    attachmentData - a byte[] continaing the contents of the attachment.
    
    Returns:
    
    the newly created attachment
    
    Throws:
    
    RemoteException
    
    Since:
    
    2.0
  - addAttachment
```
@Deprecated
RemoteAttachment addAttachment(String token,
                                           RemoteAttachment attachment,
                                           byte[] attachmentData)
                                    throws RemoteException
```
    Deprecated. since 2.7. Use addAttachment(String, long, com.atlassian.confluence.rpc.soap.beans.RemoteAttachment, byte[])
    
    Throws:
    
    RemoteException
  - getAttachment
```
RemoteAttachment getAttachment(String token,
                               long contentId,
                               String fileName,
                               int version)
                        throws RemoteException
```
    Retrieve information about an attachment.
    
    Parameters:
    
    token - the authentication token.
    
    contentId - the id of the ContentEntityObject the attachemt belongs to.
    
    fileName - the name of the attachment.
    
    version - the version number of the attachment.
    
    Returns:
    
    the attachment
    
    Throws:
    
    RemoteException
    
    Since:
    
    2.0
  - getAttachmentData
```
byte[] getAttachmentData(String token,
                         long contentId,
                         String fileName,
                         int version)
                  throws RemoteException
```
    Retrieve the contents of an attachment.
    
    Parameters:
    
    token - the authentication token.
    
    contentId - the id of the ContentEntityObject the attachemt belongs to.
    
    fileName - the name of the attachment.
    
    version - the version number of the attachment.
    
    Returns:
    
    the attachment's data
    
    Throws:
    
    RemoteException
    
    Since:
    
    2.0
  - removeAttachment
```
boolean removeAttachment(String token,
                         long contentId,
                         String fileName)
                  throws RemoteException
```
    Remove an attachment.
    
    Parameters:
    
    token - the authentication token.
    
    contentId - the id of the ContentEntityObject the attachment belongs to.
    
    fileName - the name of the attachment.
    
    Returns:
    
    true if the attachment was deleted.
    
    Throws:
    
    RemoteException
    
    Since:
    
    2.0
  - moveAttachment
```
boolean moveAttachment(String token,
                       long originalContentId,
                       String originalFileName,
                       long newContentId,
                       String newFileName)
                throws RemoteException
```
    Move or rename an attachment
    
    Parameters:
    
    token - the authentication token.
    
    originalContentId - the id of the ContentEntityObject the attachment belongs to.
    
    originalFileName - the name of the attachment.
    
    newContentId - the id of the ContentEntityObject the attachment is to be moved to.
    
    newFileName - the name the attachment is to be renamed to.
    
    Returns:
    
    true
    
    Throws:
    
    RemoteException
    
    Since:
    
    2.0
  - getComments
```
RemoteComment[] getComments(String token,
                            long pageId)
                     throws InvalidSessionException,
                            RemoteException
```
    Retrieves the comments for a given abstract page
    
    Parameters:
    
    token - the authentication token
    
    pageId - the content ID of the abstract page
    
    Returns:
    
    RemoteComment object with the comment details
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if the object for the pageId is null, or the user lacks permissions
  - getComment
```
RemoteComment getComment(String token,
                         long commentId)
                  throws InvalidSessionException,
                         RemoteException
```
    Retrieves a comment with the given ID
    
    Parameters:
    
    token - The token identifying the current user
    
    commentId - The ID of the comment to be retrieved
    
    Returns:
    
    A RemoteComment object containing the comment information
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if the comment cannot be found
    
    RemoteException - if the comment cannot be viewed by the user
    
    RemoteException - if the page the comment is on cannot be viewed by the user
    
    RemoteException - if the retrieved object is not a comment
    
    Since:
    
    2.0
  - addComment
```
RemoteComment addComment(String token,
                         RemoteComment comment)
                  throws InvalidSessionException,
                         NotPermittedException,
                         RemoteException
```
    Adds a comment to a page or blog post
    
    Parameters:
    
    token - The token identifying the current user
    
    comment - The RemoteComment object containing the comment information
    
    Returns:
    
    RemoteComment object
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if the user does not have permission to view the page the comment is being posted to, or it does not exist
    
    NotPermittedException - if the user is unable to post the comment
    
    Since:
    
    2.0
  - editComment
```
RemoteComment editComment(String token,
                          RemoteComment comment)
                   throws InvalidSessionException,
                          NotPermittedException,
                          RemoteException
```
    Updates a comment
    
    Parameters:
    
    token - The token identifying the current user
    
    comment - The RemoteComment object containing the comment information
    
    Returns:
    
    RemoteComment object
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if the user does not have permission to view the page the comment is being posted to, or it does not exist
    
    NotPermittedException - if the user is unable to edit the comment
    
    Since:
    
    2.4
  - removeComment
```
boolean removeComment(String token,
                      long commentId)
               throws InvalidSessionException,
                      NotPermittedException,
                      RemoteException
```
    Removes a comment with the given ID
    
    Parameters:
    
    token - The token identifying the current user
    
    commentId - The ID of the comment to remove
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if the user does not have permission to view the page the comment is on, or it does not exist
    
    RemoteException - if the comment does not exist
    
    NotPermittedException - if the user does not have permission to remove the comment
    
    Since:
    
    2.0
  - search
```
RemoteSearchResult[] search(String token,
                            String query,
                            int maxResults)
                     throws InvalidSessionException,
                            RemoteException
```
    Search Confluence for the supplied query String. Please be sensible in your use of the maxResults parameter. Too large a value will result in this call taking a long time.
    
    Parameters:
    
    token - the authentication token
    
    query - the query term for the search
    
    maxResults - the maximum number of results to be returned.
    
    Returns:
    
    an array of RemoteSearchResults. If there are no results then an empty array will be returned.
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - search
```
RemoteSearchResult[] search(String token,
                            String query,
                            Map params,
                            int maxResults)
                     throws RemoteException
```
    Search Confluence for the supplied query String. Please be sensible in your use of the maxResults parameter.
    
    A Map of search criteria can be specified. The following keys are understood -
    - spaceKey - a key representing a single space to limit the search to.
    - type - the type of content to limit the search to.
    - modified - a String representation of a time range. See the Bonnie documentation for com.atlassian.bonnie.search.SinceDateQueryFactory for a list of understood representations.
    Parameters:
    
    token - the authentication token
    
    params - a Map providing criteria to the search.
    
    query - the query term for the search
    
    maxResults - the maximum number of results to be returned.
    
    Returns:
    
    an array of RemoteSearchResults. If there are no results then an empty array will be returned.
    
    Throws:
    
    RemoteException
  - getBlogEntryByDayAndTitle
```
RemoteBlogEntry getBlogEntryByDayAndTitle(String token,
                                          String spaceKey,
                                          int dayOfMonth,
                                          String postTitle)
                                   throws RemoteException
```
    Retrieves a blog post in the Space with the given spaceKey, with the title 'postTitle' and posted on the day 'dayOfMonth'
    
    Parameters:
    
    token - the authentication token
    
    spaceKey - the key of the Space the blog post belongs to
    
    dayOfMonth - the day of the month the blog post was made
    
    postTitle - the title of the blog post
    
    Returns:
    
    A RemoteBlogEntry object
    
    Throws:
    
    RemoteException - if the user does not have permission to view the blog post, or it does not exist
    
    Since:
    
    2.0
  - getBlogEntryByDateAndTitle
```
RemoteBlogEntry getBlogEntryByDateAndTitle(String token,
                                           String spaceKey,
                                           int year,
                                           int month,
                                           int dayOfMonth,
                                           String postTitle)
                                    throws RemoteException
```
    Retrieves a blog post in the given space, with the title and date as specified.
    
    Returns:
    
    a blog post matching the criteria
    
    Throws:
    
    RemoteException - if the user does not have permission to view the blog post or it does not exist
  - getBlogEntry
```
RemoteBlogEntry getBlogEntry(String token,
                             long entryId)
                      throws RemoteException
```
    Throws:
    
    RemoteException
  - getBlogEntries
```
RemoteBlogEntrySummary[] getBlogEntries(String token,
                                        String spaceKey)
                                 throws InvalidSessionException,
                                        RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - storeBlogEntry
```
RemoteBlogEntry storeBlogEntry(String token,
                               RemoteBlogEntry blogEntry)
                        throws VersionMismatchException,
                               NotPermittedException,
                               InvalidSessionException,
                               RemoteException
```
    Throws:
    
    VersionMismatchException
    
    NotPermittedException
    
    InvalidSessionException
    
    RemoteException
  - getServerInfo
```
RemoteServerInfo getServerInfo(String token)
                        throws InvalidSessionException,
                               RemoteException
```
    Throws:
    
    InvalidSessionException
    
    RemoteException
  - exportSpace
```
String exportSpace(String token,
                   String spaceKey,
                   String exportType)
            throws RemoteException
```
    Throws:
    
    RemoteException
  - exportSpace
```
String exportSpace(String token,
                   String spaceKey,
                   String exportType,
                   boolean exportAll)
            throws RemoteException
```
    Throws:
    
    RemoteException
  - exportSite
```
String exportSite(String token,
                  boolean exportAttachments)
           throws RemoteException
```
    Throws:
    
    RemoteException
  - performBackup
```
String performBackup(String token,
                     boolean exportAttachments)
              throws RemoteException
```
    Throws:
    
    RemoteException
  - importSpace
```
boolean importSpace(String token,
                    byte[] importData)
             throws RemoteException
```
    Import a space in a compressed XML format
    
    Parameters:
    
    token - The authentication token
    
    importData - The contents of the Space export file
    
    Returns:
    
    True if successful, otherwise false
    
    Throws:
    
    RemoteException - If the space exists or the export file is invalid
    
    Since:
    
    2.4
  - flushIndexQueue
```
boolean flushIndexQueue(String token)
                 throws RemoteException
```
    Throws:
    
    RemoteException
  - clearIndexQueue
```
boolean clearIndexQueue(String token)
                 throws RemoteException
```
    Throws:
    
    RemoteException
  - recoverMainIndex
```
boolean recoverMainIndex(String token)
                  throws RemoteException
```
    Throws:
    
    RemoteException
  - getClusterInformation
```
RemoteClusterInformation getClusterInformation(String token)
                                        throws RemoteException
```
    Throws:
    
    RemoteException
  - getClusterNodeStatuses
```
RemoteNodeStatus[] getClusterNodeStatuses(String token)
                                   throws RemoteException
```
    Throws:
    
    RemoteException
  - getGroups
```
String[] getGroups(String token)
            throws NotPermittedException,
                   RemoteException
```
    Retrieves a list of user groups
    
    Parameters:
    
    token - The token identifying the current user
    
    Returns:
    
    An array of group names
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    RemoteException
  - hasGroup
```
boolean hasGroup(String token,
                 String groupname)
          throws InvalidSessionException,
                 RemoteException
```
    Determines whether a group exists
    
    Parameters:
    
    token - the token identifying the current user
    
    groupname - the group to look up
    
    Returns:
    
    True if the user exists, false otherwise
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
    
    Since:
    
    2.0
  - addGroup
```
boolean addGroup(String token,
                 String groupname)
          throws NotPermittedException,
                 InvalidSessionException,
                 RemoteException
```
    Adds a new group
    
    Parameters:
    
    token - The token identifying the current user
    
    groupname - The name of the group to be added
    
    Returns:
    
    True when the group was successfully added, false if it already exists
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    InvalidSessionException
    
    RemoteException
  - removeGroup
```
boolean removeGroup(String token,
                    String groupname,
                    String defaultGroupName)
             throws NotPermittedException,
                    InvalidSessionException,
                    RemoteException
```
    Removes an existing group
    If a valid defaultGroupName is specified, users will be added to the new group (defaultGroupName).
    
    Parameters:
    
    token - The token identifying the current user
    
    groupname - The name of the group to be removed
    
    defaultGroupName - The name of the group that users will be moved to
    
    Returns:
    
    True if successful, false otherwise.
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    InvalidSessionException
    
    RemoteException - if the given groupname does not exist
    
    RemoteException - if the given defaultGroupName does not exist
  - removeAllPermissionsForGroup
```
boolean removeAllPermissionsForGroup(String token,
                                     String groupname)
                              throws RemoteException
```
    Deletes all global and space permissions for the given group
    
    Parameters:
    
    token - The token identifying the current user
    
    groupname - The group to delete permissions for
    
    Returns:
    
    True if successful, false otherwise.
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    RemoteException - if the given groupname does not exist
  - getUserGroups
```
String[] getUserGroups(String token,
                       String username)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Retrieves the groups that a given user belongs to
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username to retrieve groups for
    
    Returns:
    
    An array of group names as Strings
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    InvalidSessionException
    
    RemoteException - if the given username does not exist
  - addUserToGroup
```
boolean addUserToGroup(String token,
                       String username,
                       String groupname)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Parameters:
    
    token -
    
    username -
    
    groupname -
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    InvalidSessionException
    
    RemoteException - if the given username does not exist
    
    RemoteException - if the given groupname does not exist
  - removeUserFromGroup
```
boolean removeUserFromGroup(String token,
                            String username,
                            String groupname)
                     throws NotPermittedException,
                            InvalidSessionException,
                            RemoteException
```
    Removes the given user from a group
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username to remove from a group
    
    groupname - The name of the group the user is to be removed from
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    NotPermittedException - if the current user lacks permission to administer
    
    InvalidSessionException
    
    RemoteException - if the given username does not exist
    
    RemoteException - if the given groupname does not exist
  - getUser
```
@Deprecated
RemoteUser getUser(String token,
                               String username)
                        throws InvalidSessionException,
                               RemoteException
```
    Deprecated. since 5.2. Use getUserByName(String, String) instead.
    
    Retrieves a user with the given username
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user to be retrieved
    
    Returns:
    
    A RemoteUser object, containing the username, full name, email and URL
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
  - getUserByName
```
RemoteConfluenceUser getUserByName(String token,
                                   String username)
                            throws InvalidSessionException,
                                   RemoteException
```
    Retrieves a user with the given username.
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user to be retrieved
    
    Returns:
    
    A RemoteConfluenceUser object, containing the user key, username, full name, email and URL
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
    
    Since:
    
    5.2
  - getUserByKey
```
RemoteConfluenceUser getUserByKey(String token,
                                  String userKey)
                           throws InvalidSessionException,
                                  RemoteException
```
    Retrieves a user with the given user key.
    
    Parameters:
    
    token - The token identifying the current user
    
    userKey - The user key of the user to be retrieved
    
    Returns:
    
    A RemoteUser object, containing the user key, username, full name, email and URL
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if a user with the given user key cannot be found
    
    Since:
    
    5.2
  - setUserPreferenceBoolean
```
boolean setUserPreferenceBoolean(String token,
                                 String username,
                                 String key,
                                 boolean value)
                          throws InvalidSessionException,
                                 RemoteException
```
    Set a user preference to a boolean value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    value - The value
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred
  - getUserPreferenceBoolean
```
boolean getUserPreferenceBoolean(String token,
                                 String username,
                                 String key)
                          throws InvalidSessionException,
                                 RemoteException
```
    Get a user preference as a boolean value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred (including not being able to find the key)
  - setUserPreferenceLong
```
boolean setUserPreferenceLong(String token,
                              String username,
                              String key,
                              long value)
                       throws InvalidSessionException,
                              RemoteException
```
    Set a user preference to an long integer value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    value - The value
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred
  - getUserPreferenceLong
```
long getUserPreferenceLong(String token,
                           String username,
                           String key)
                    throws InvalidSessionException,
                           RemoteException
```
    Get a user preference as a long integer value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred (including not being able to find the key)
  - setUserPreferenceString
```
boolean setUserPreferenceString(String token,
                                String username,
                                String key,
                                String value)
                         throws InvalidSessionException,
                                RemoteException
```
    Set a user preference to a String value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    value - The value
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred
  - getUserPreferenceString
```
String getUserPreferenceString(String token,
                               String username,
                               String key)
                        throws InvalidSessionException,
                               RemoteException
```
    Get a user preference as a String value.
    
    Parameters:
    
    token - the token identifying the current user
    
    key - The user preference key
    
    Throws:
    
    InvalidSessionException - If the rpc token expired
    
    RemoteException - If any other exception occurred (including not being able to find the key)
  - hasUser
```
boolean hasUser(String token,
                String username)
         throws InvalidSessionException,
                RemoteException
```
    Determines whether a user exists
    
    Parameters:
    
    token - the token identifying the current user
    
    username - the username to look up
    
    Returns:
    
    True if the user exists, false otherwise
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
    
    Since:
    
    2.0
  - addUser
```
void addUser(String token,
             RemoteUser remoteUser,
             String password)
      throws NotPermittedException,
             InvalidSessionException,
             RemoteException
```
    Adds a user with the given RemoteUser object and password
    
    Parameters:
    
    token - The token identifying the current user
    
    remoteUser - The object containing the user information
    
    password - The password of the user
    
    Throws:
    
    NotPermittedException - if the current user lacks permissions to create new users
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
  - addUser
```
void addUser(String token,
             RemoteUser remoteUser,
             String password,
             boolean notifyUser)
      throws NotPermittedException,
             InvalidSessionException,
             RemoteException
```
    Adds a user with the given RemoteUser object and password
    
    Parameters:
    
    token - The token identifying the current user
    
    remoteUser - The object containing the user information
    
    password - The password of the user
    
    notifyUser - Whether or not you want the new user to be notified of their new account
    
    Throws:
    
    NotPermittedException - if the current user lacks permissions to create new users
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
  - removeUser
```
boolean removeUser(String token,
                   String username)
            throws NotPermittedException,
                   InvalidSessionException,
                   RemoteException
```
    Removes a user with the given username
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user to be removed
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    InvalidSessionException
    
    NotPermittedException - if the current user lacks the permission to remove users
    
    RemoteException - if the given username cannot be found
    
    RemoteException - if the user has authored content
  - editUser
```
boolean editUser(String token,
                 RemoteUser remoteUser)
          throws NotPermittedException,
                 InvalidSessionException,
                 RemoteException
```
    Edits a user with the values in the given RemoteUser object
    Currently this will only update the user's full name and email
    
    Parameters:
    
    token - The token identifying the current user
    
    remoteUser - The object containing the user information
    
    Throws:
    
    NotPermittedException - if the current user cannot administer users or is not the actual user
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
    
    Since:
    
    2.0
  - deactivateUser
```
boolean deactivateUser(String token,
                       String username)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Deactivates the given user
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user to deactivate
    
    Returns:
    
    True if the user was successfully deactivated, false otherwise
    
    Throws:
    
    NotPermittedException - if the current user does not have permissions to perform the action
    
    InvalidSessionException
    
    RemoteException - if the given username cannot be found
    
    RemoteException - if the user has already been deactivated
    
    Since:
    
    2.0
  - reactivateUser
```
boolean reactivateUser(String token,
                       String username)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Reactivates the given user
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user to reactivate
    
    Returns:
    
    True if the user was successfully reactivated, false otherwise
    
    Throws:
    
    NotPermittedException - if the current user does not have permissions to perform the action
    
    InvalidSessionException
    
    RemoteException - if the given username cannot be found
    
    RemoteException - if the user is already active
    
    Since:
    
    2.0
  - isActiveUser
```
boolean isActiveUser(String token,
                     String username)
              throws NotPermittedException,
                     RemoteException
```
    Checks if a given user is active.
    
    Parameters:
    
    username - The username to check
    
    Returns:
    
    True if the user is active or does not exist, false otherwise.
    
    Throws:
    
    RemoteException - If the username does not exist
    
    NotPermittedException
  - getActiveUsers
```
String[] getActiveUsers(String token,
                        boolean viewAll)
                 throws InvalidSessionException,
                        RemoteException
```
    Returns a list of the current system users
    
    Parameters:
    
    token - The token identifying the current user
    
    viewAll - Whether all users should be shown. When it is false, all users in the default users group will be returned. Otherwise, every registered user is returned.
    
    Returns:
    
    An array of usernames as Strings
    
    Throws:
    
    NotPermittedException - if the current user does not have administration permissions
    
    InvalidSessionException
    
    RemoteException
    
    Since:
    
    2.0
  - setUserInformation
```
boolean setUserInformation(String token,
                           RemoteUserInformation userInfo)
                    throws NotPermittedException,
                           InvalidSessionException,
                           RemoteException
```
    Updates a user's information
    Currently this will only update a user's "description", stored in the 'content' attribute
    
    Parameters:
    
    token - The token identifying the current user
    
    userInfo - A RemoteUserInformation object, containing the username, email, fullname, url and information
    
    Throws:
    
    NotPermittedException - if the current user cannot administer users or is not the actual user
    
    InvalidSessionException
    
    RemoteException - if there was an error saving the personal information
    
    Since:
    
    2.0
  - getUserInformation
```
RemoteUserInformation getUserInformation(String token,
                                         String username)
                                  throws InvalidSessionException,
                                         RemoteException
```
    Retrieves a user's information
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The name of the user to get information on
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if a user with the given username cannot be found
    
    Since:
    
    2.0
  - changeMyPassword
```
boolean changeMyPassword(String token,
                         String oldPass,
                         String newPass)
                  throws InvalidSessionException,
                         RemoteException
```
    Change the current user's password
    
    Parameters:
    
    token - The token identifying the current user
    
    oldPass - The old password of the user, required for security purposes
    
    newPass - The new password for the user
    
    Throws:
    
    NotPermittedException - if newPass was incorrect
    
    InvalidSessionException
    
    RemoteException - if oldPass does not match the user's password
    
    RemoteException - if newPass is null or an empty String
    
    RemoteException - if there are problems setting the password in the UserAccessor
    
    Since:
    
    2.0
  - changeUserPassword
```
boolean changeUserPassword(String token,
                           String username,
                           String newPass)
                    throws NotPermittedException,
                           InvalidSessionException,
                           RemoteException
```
    Change a user's password
    
    Parameters:
    
    token - The token identifying the current user
    
    username - The username of the user we are changing the password for
    
    newPass - The new password for the user
    
    Throws:
    
    NotPermittedException - if the current user does not have permission to administer the user
    
    InvalidSessionException
    
    RemoteException - if the user cannot be found
    
    RemoteException - if newPass is null or an empty String
    
    RemoteException - if there are problems setting the password in the UserAccessor
    
    Since:
    
    2.0
  - addProfilePicture
```
boolean addProfilePicture(String token,
                          String userName,
                          String fileName,
                          String mimeType,
                          byte[] pictureData)
                   throws NotPermittedException,
                          InvalidSessionException,
                          RemoteException
```
    Add a profile picture to a user's profile
    
    Parameters:
    
    userName - The user name of the profile
    
    fileName - File name of the picture
    
    mimeType - Image mime type (must be from image/*)
    
    pictureData - The image data
    
    Returns:
    
    true if successful
    
    Throws:
    
    NotPermittedException - Principal is not permitted to add pictures to the specified profile
    
    InvalidSessionException
    
    RemoteException - if the user can not be found
    
    RemoteException - if the mimeType is not from image/*
    
    RemoteException - if the image can not be processed
    
    Since:
    
    2.2
  - renameUser
```
boolean renameUser(String token,
                   String oldUsername,
                   String newUsername)
            throws RemoteException
```
    Change user's username
    
    Parameters:
    
    token - The token identifying the current user
    
    oldUsername - current username of the user
    
    newUsername - new username of the user
    
    Returns:
    
    true if successful
    
    Throws:
    
    NotPermittedException - if the current user does not have permissions to perform the action
    
    InvalidSessionException
    
    RemoteException - if the new username does not meet username requirements
    
    RemoteException - if the user could not be renamed
    
    Since:
    
    5.2
  - renameUsers
```
String[] renameUsers(String token,
                     Map<String,String> oldUsernamesToNewUsernames)
              throws RemoteException
```
    Change usernames for a set of users
    
    Parameters:
    
    token - The token identifying the current user
    
    oldUsernamesToNewUsernames - mapping of current usernames to new usernames of users
    
    Returns:
    
    empty array if the operation was successful or usernames of users that could not be renamed
    
    Throws:
    
    NotPermittedException - if the current user does not have permissions to perform the action
    
    InvalidSessionException
    
    RemoteException - if a new username does not meet username requirements
    
    RemoteException - if a user could not be renamed
    
    Since:
    
    5.2
  - getLabelsById
```
RemoteLabel[] getLabelsById(String token,
                            long objectId)
                     throws InvalidSessionException,
                            RemoteException
```
    Returns all labels for the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    objectId - The ID of the ContentEntityObject the method will retrieve the labels for
    
    Returns:
    
    An array of RemoteLabel objects
    
    Throws:
    
    RemoteException - if the object cannot be retrieved from the ContentEntityManager
    
    RemoteException - if the given user does not have VIEW permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getMostPopularLabels
```
RemoteLabel[] getMostPopularLabels(String token,
                                   int maxCount)
                            throws InvalidSessionException,
                                   RemoteException
```
    Returns the most popular labels for the Confluence instance, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    maxCount - The maximum number of labels to return. A maxCount of 0 means there is no limit.
    
    Returns:
    
    An array of RemoteLabel objects, sorted by descending popularity
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
    
    Since:
    
    2.0
  - getMostPopularLabelsInSpace
```
RemoteLabel[] getMostPopularLabelsInSpace(String token,
                                          String spaceKey,
                                          int maxCount)
                                   throws InvalidSessionException,
                                          RemoteException
```
    Returns the most popular labels for the given spaceKey, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    spaceKey - The key of the space to limit the labels to
    
    maxCount - The maximum number of labels to return. A maxCount of 0 means there is no limit.
    
    Returns:
    
    An array of RemoteLabel objects, sorted by descending popularity
    
    Throws:
    
    RemoteException - if the space cannot be retrieved from the SpaceManager
    
    NotPermittedException - if the given user does not have VIEW permissions for the space
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getRecentlyUsedLabels
```
RemoteLabel[] getRecentlyUsedLabels(String token,
                                    int maxResults)
                             throws InvalidSessionException,
                                    RemoteException
```
    Returns the recently used labels for the Confluence instance, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    maxResults - The maximum number of labels to return. A value of 0 means the default is used.
    
    Returns:
    
    An array of RemoteLabel objects, sorted by most recent use
    
    Throws:
    
    InvalidSessionException
    
    RemoteException
    
    Since:
    
    2.0
  - getRecentlyUsedLabelsInSpace
```
RemoteLabel[] getRecentlyUsedLabelsInSpace(String token,
                                           String spaceKey,
                                           int maxResults)
                                    throws InvalidSessionException,
                                           RemoteException
```
    Returns the recently used labels for the given spaceKey, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    spaceKey - The key of the space to limit the labels to
    
    maxResults - The maximum number of labels to return. A value of 0 means the default is used.
    
    Returns:
    
    An array of RemoteLabel objects, sorted by most recent use
    
    Throws:
    
    RemoteException - if the space does not exist, or the user lacks permission to view it
    
    NotPermittedException - if the given user does not have VIEW permissions for the space
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getSpacesWithLabel
```
RemoteSpace[] getSpacesWithLabel(String token,
                                 String labelName)
                          throws InvalidSessionException,
                                 RemoteException
```
    Returns an array of Spaces that have been labelled with labelName
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label (namespace prefixes permitted)
    
    Returns:
    
    An array of RemoteSpace instances
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if labelName is an empty string or null
    
    RemoteException - if labelName contains an invalid namespace prefix
    
    RemoteException - if a label named labelName cannot be found
    
    Since:
    
    2.0
  - getRelatedLabels
```
RemoteLabel[] getRelatedLabels(String token,
                               String labelName,
                               int maxResults)
                        throws InvalidSessionException,
                               RemoteException
```
    Returns the labels related to the given label name, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label (namespace prefixes permitted)
    
    maxResults - The maximum number of labels to return. A value of 0 means the default is used.
    
    Returns:
    
    An array of RemoteLabel objects (sorted by frequency of use)
    
    Throws:
    
    RemoteException - if labelName is an empty string or null
    
    RemoteException - if labelName contains an invalid namespace prefix
    
    RemoteException - if a label named labelName cannot be found
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getRelatedLabelsInSpace
```
RemoteLabel[] getRelatedLabelsInSpace(String token,
                                      String labelName,
                                      String spaceKey,
                                      int maxResults)
                               throws InvalidSessionException,
                                      RemoteException
```
    Returns the labels related to the given label name for the given spaceKey, with a specified maximum number of results.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label (namespace prefixes permitted)
    
    spaceKey - The key of the space to limit the labels to
    
    maxResults - The maximum number of labels to return. A maxCount of 0 means the default is used.
    
    Returns:
    
    An array of RemoteLabel objects (sorted by frequency of use)
    
    Throws:
    
    RemoteException - if labelName is an empty string or null
    
    RemoteException - if labelName contains an invalid namespace prefix
    
    RemoteException - if a label named labelName cannot be found
    
    RemoteException - if the Space does not exist, or the user does not have VIEW permissions
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getLabelsByDetail
```
RemoteLabel[] getLabelsByDetail(String token,
                                String labelName,
                                String namespace,
                                String spaceKey,
                                String owner)
                         throws InvalidSessionException,
                                RemoteException
```
    Retrieves the labels matching the given labelName, namespace or owner.
    This method can be used to retrieve labels of a specfic type, such as personal labels, by setting the namespace.
    Parameters with empty strings are ignored.
    
    Parameters:
    
    token - the authentication token for the user
    
    labelName - the name of the label to search for (not parsed for prefixes)
    
    namespace - the namespace to restrict by
    
    spaceKey - the key of the space to restrict by
    
    owner - the owner of the labels
    
    Returns:
    
    an array of matching RemoteLabel objects
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if labelName is an empty string or null
    
    RemoteException - if labelName contains an invalid namespace prefix
    
    RemoteException - if a label named labelName cannot be found
    
    RemoteException - if the Space does not exist, or the user does not have VIEW permissions
    
    RemoteException - if the owner is not a valid user
    
    Since:
    
    2.0
    
    See Also:
    
    Namespace
  - getLabelContentById
```
RemoteSearchResult[] getLabelContentById(String token,
                                         long labelId)
                                  throws InvalidSessionException,
                                         RemoteException
```
    Returns the content for a given label ID
    
    Parameters:
    
    token - The token identifying the current user
    
    labelId - The ID of the label
    
    Returns:
    
    An array of RemoteSearchResult objects
    
    Throws:
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getLabelContentByName
```
RemoteSearchResult[] getLabelContentByName(String token,
                                           String labelName)
                                    throws InvalidSessionException,
                                           RemoteException
```
    Returns the content for a given label name
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of a label (namespace prefixes permitted)
    
    Returns:
    
    An array of RemoteSearchResult objects
    
    Throws:
    
    RemoteException - if the label name is null
    
    RemoteException - if the label name is an empty String
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getLabelContentByObject
```
RemoteSearchResult[] getLabelContentByObject(String token,
                                             RemoteLabel labelObject)
                                      throws InvalidSessionException,
                                             RemoteException
```
    Returns the content for a given label object
    
    Parameters:
    
    token - The token identifying the current user
    
    labelObject - The RemoteLabel object
    
    Returns:
    
    An array of RemoteSearchResult objects
    
    Throws:
    
    RemoteException - if the RemoteLabel object is null
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getSpacesContainingContentWithLabel
```
RemoteSpace[] getSpacesContainingContentWithLabel(String token,
                                                  String labelName)
                                           throws InvalidSessionException,
                                                  RemoteException
```
    Returns all Spaces that have content labelled with labelName
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The label to retrieve the content for (namespace prefixes permitted)
    
    Returns:
    
    An array of RemoteSpace instances (order undefined)
    
    Throws:
    
    InvalidSessionException
    
    RemoteException - if labelName is an empty string or null
    
    RemoteException - if labelName contains an invalid namespace prefix
    
    RemoteException - if a label named labelName cannot be found
    
    Since:
    
    2.0
  - addLabelByName
```
boolean addLabelByName(String token,
                       String labelName,
                       long objectId)
                throws NotPermittedException,
                       InvalidSessionException,
                       RemoteException
```
    Adds a label to the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label(s) to be added to the ContentEntityObject, in the form of a space-separated string
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully added, false otherwise.
    
    Throws:
    
    RemoteException - if the label name is null or an empty String
    
    RemoteException - if the split label name is invalid (as determined by LabelUtil.split())
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user does not have VIEW permissions for the object
    
    RemoteException - if the label could not be created
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - addLabelById
```
boolean addLabelById(String token,
                     long labelId,
                     long objectId)
              throws NotPermittedException,
                     InvalidSessionException,
                     RemoteException
```
    Adds a label with the given ID to the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelId - The ID of the label to be added to the ContentEntityObject
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully added, false otherwise.
    
    Throws:
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user lacks VIEW permissions for the object
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - addLabelByObject
```
boolean addLabelByObject(String token,
                         RemoteLabel labelObject,
                         long objectId)
                  throws NotPermittedException,
                         InvalidSessionException,
                         RemoteException
```
    Adds the given label object to the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelObject - The label to be added to the ContentEntityObject
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully added, false otherwise.
    
    Throws:
    
    RemoteException - if the given RemoteLabel object is null
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user lacks VIEW permissions for the object
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - addLabelByNameToSpace
```
boolean addLabelByNameToSpace(String token,
                              String labelName,
                              String spaceKey)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
```
    Adds a label to the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label(s) to be added to the Space, in the form of a space-separated string
    
    spaceKey - The Space to add the label to
    
    Returns:
    
    True if successfully added, false otherwise.
    
    Throws:
    
    RemoteException - if the label name is null or an empty String
    
    RemoteException - if the split label name is invalid (as determined by LabelUtil.split())
    
    RemoteException - if the space does not exist, or the user does not have VIEW permissions
    
    RemoteException - if the label could not be created
    
    NotPermittedException - if the user does not have permission to add the label
    
    InvalidSessionException
    
    Since:
    
    2.0
  - removeLabelByName
```
boolean removeLabelByName(String token,
                          String labelName,
                          long objectId)
                   throws NotPermittedException,
                          InvalidSessionException,
                          RemoteException
```
    Removes the given label from the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label(s) to be removed from the ContentEntityObject, in the form of a space-separated String
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully removed, false otherwise.
    
    Throws:
    
    RemoteException - if the label name is null
    
    RemoteException - if the label name is an empty String
    
    RemoteException - if one of the given label names does not exist (occurs before removing labels)
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user lacks VIEW permissions for the object
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - removeLabelById
```
boolean removeLabelById(String token,
                        long labelId,
                        long objectId)
                 throws NotPermittedException,
                        InvalidSessionException,
                        RemoteException
```
    Removes the label with the given ID from the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelId - The ID of the label to be removed from the ContentEntityObject
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully removed, false otherwise.
    
    Throws:
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user lacks VIEW permissions for the object
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - removeLabelByObject
```
boolean removeLabelByObject(String token,
                            RemoteLabel labelObject,
                            long objectId)
                     throws NotPermittedException,
                            InvalidSessionException,
                            RemoteException
```
    Removes the given label object from the object with the given ContentEntityObject ID.
    
    Parameters:
    
    token - The token identifying the current user
    
    labelObject - The label to be removed from the ContentEntityObject
    
    objectId - The ID of the ContentEntityObject the method will act on
    
    Returns:
    
    True if successfully removed, false otherwise.
    
    Throws:
    
    RemoteException - if the RemoteLabel object is null
    
    RemoteException - if a Label could not be retrieved for the given ID
    
    RemoteException - if the object was not valid
    
    RemoteException - if the user lacks VIEW permissions for the object
    
    NotPermittedException - if the user lacks EDIT permissions for the object
    
    InvalidSessionException
    
    Since:
    
    2.0
  - removeLabelByNameFromSpace
```
boolean removeLabelByNameFromSpace(String token,
                                   String labelName,
                                   String spaceKey)
                            throws NotPermittedException,
                                   InvalidSessionException,
                                   RemoteException
```
    Removes the given label from the given Space
    
    Parameters:
    
    token - The token identifying the current user
    
    labelName - The name of the label(s) to be removed from the Space, in the form of a space-separated String
    
    spaceKey - The Space the method will act on
    
    Returns:
    
    True if successfully removed, false otherwise.
    
    Throws:
    
    RemoteException - if the label name is null
    
    RemoteException - if the label name is an empty String
    
    RemoteException - if one of the given label names does not exist (occurs before removing labels)
    
    RemoteException - if the space does not exist, or the user lacks VIEW permissions
    
    NotPermittedException - if the user lacks EDIT permissions for the Space
    
    InvalidSessionException
    
    Since:
    
    2.0
  - getContentPermissionSets
```
RemoteContentPermissionSet[] getContentPermissionSets(String token,
                                                      long contentId)
                                               throws NotPermittedException,
                                                      InvalidSessionException,
                                                      RemoteException
```
    Get the content permission sets for a particular piece of content
    
    Parameters:
    
    token - the login token for the current user
    
    contentId - the content ID of the content to be looked up
    
    Returns:
    
    an array of the permission sets applied to that content
    
    Throws:
    
    NotPermittedException - if the content can not be found, or can not be accessed by the current user
    
    InvalidSessionException - if no login session can be found for the supplied token
    
    RemoteException - if something random goes wrong
  - getContentPermissionSet
```
RemoteContentPermissionSet getContentPermissionSet(String token,
                                                   long contentId,
                                                   String permissionType)
                                            throws NotPermittedException,
                                                   InvalidSessionException,
                                                   RemoteException
```
    Get the content permission set of a certain type for a particular piece of content
    
    Parameters:
    
    token - the login token for the current user
    
    contentId - the content ID of the content to be looked up
    
    permissionType - type of content permission
    
    Returns:
    
    a content permission set of the specified type on the content object to be looked up
    
    Throws:
    
    NotPermittedException - if the content can not be found, or can not be accessed by the current user
    
    InvalidSessionException - if no login session can be found for the supplied token
    
    RemoteException - if something random goes wrong
  - setContentPermissions
```
boolean setContentPermissions(String token,
                              long contentId,
                              String permissionType,
                              RemoteContentPermission[] remoteContentPermissions)
                       throws NotPermittedException,
                              InvalidSessionException,
                              RemoteException
```
    Set the content permissions for a particular permission type on some content. These permissions will replace any permissions that already exist for that permission type.
    
    Parameters:
    
    token - the login token
    
    contentId - the id of the content to have permissions set on it
    
    permissionType - the type of the permissions (one of the constants from ContentPermission)
    
    remoteContentPermissions - the permissions to set
    
    Returns:
    
    true (because RPC methods can't be void)
    
    Throws:
    
    NotPermittedException - if the content can not be found or can not be accessed by the current user
    
    InvalidSessionException - if no login session can be found for the supplied token
    
    RemoteException - if something random goes wrong
  - addGlobalPermission
```
boolean addGlobalPermission(String token,
                            String permission,
                            String remoteEntityName)
                     throws NotPermittedException,
                            RemoteException
```
    Add global permissions for a user or group
    
    Parameters:
    
    token - the login token
    
    permission - the Space Permission to add
    
    remoteEntityName - the name of the user or group
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException
  - addGlobalPermissions
```
boolean addGlobalPermissions(String token,
                             String[] permissions,
                             String remoteEntityName)
                      throws NotPermittedException,
                             RemoteException
```
    Add a global permission for a user or group
    
    Parameters:
    
    token - the login token
    
    permissions - Array of permissions to add
    
    remoteEntityName - the name of the user or group
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException
  - removeGlobalPermission
```
boolean removeGlobalPermission(String token,
                               String permission,
                               String remoteEntityName)
                        throws RemoteException
```
    Remove a global permission
    
    Parameters:
    
    token - the login token
    
    permission - the Space Permission to add
    
    remoteEntityName - the name of the user or group
    
    Returns:
    
    True if successful, false otherwise
    
    Throws:
    
    NotPermittedException - if the user lacks permissions to perform the action
    
    RemoteException
  - addAnonymousUsePermission
```
boolean addAnonymousUsePermission(String token)
                           throws RemoteException
```
    Throws:
    
    RemoteException
  - removeAnonymousUsePermission
```
boolean removeAnonymousUsePermission(String token)
                              throws RemoteException
```
    Remove anonymous use permission. If the anonymous user also has 'view user profile' permission then this will also be removed.
    
    Parameters:
    
    token - the login token
    
    Returns:
    
    true if successful, false otherwise.
    
    Throws:
    
    RemoteException
  - addAnonymousViewUserProfilePermission
```
boolean addAnonymousViewUserProfilePermission(String token)
                                       throws RemoteException
```
    This permission can only be set if the anonymous user already has 'use' permission. If this is not the case then false will be returned.
    
    Parameters:
    
    token - the login token
    
    Returns:
    
    true if successfully set; otherwise false.
    
    Throws:
    
    RemoteException
  - removeAnonymousViewUserProfilePermission
```
boolean removeAnonymousViewUserProfilePermission(String token)
                                          throws RemoteException
```
    Throws:
    
    RemoteException
  - setEnableWysiwyg
```
@Deprecated
boolean setEnableWysiwyg(String token,
                                     boolean value)
                              throws RemoteException
```
    Deprecated. since 4.0. You can no longer disable the wysiwyg editor.
    
    Throws:
    
    RemoteException
  - setEnableAnonymousAccess
```
boolean setEnableAnonymousAccess(String token,
                                 boolean value)
                          throws RemoteException
```
    Throws:
    
    RemoteException
  - isPluginEnabled
```
boolean isPluginEnabled(String token,
                        String pluginKey)
                 throws RemoteException
```
    Returns true if the specified plugin is enabled.
    
    Throws:
    
    RemoteException
  - isPluginInstalled
```
boolean isPluginInstalled(String token,
                          String pluginKey)
                   throws RemoteException
```
    Returns true if the specified plugin is installed.
    
    Throws:
    
    RemoteException
  - installPlugin
```
boolean installPlugin(String token,
                      String pluginFileName,
                      byte[] pluginData)
               throws RemoteException
```
    Installs a plugin.
    
    Parameters:
    
    pluginFileName - the original filename of the plugin. It should end with the correct file extension .xml or .jar.
    
    pluginData - a byte[] containing the contents of the plugin xml or jar file.
    
    Throws:
    
    RemoteException
  - isDarkFeatureEnabled
```
boolean isDarkFeatureEnabled(String token,
                             String key)
                      throws RemoteException
```
    Throws:
    
    RemoteException

Interface ConfluenceSoapService

Field Summary

Method Summary

Field Detail

VIEW_PERMISSION

MODIFY_PERMISSION

COMMENT_PERMISSION

ADMIN_SPACE_PERMISSION

Method Detail

login

logout

getSpaces

getSpacesInGroup

addSpaceWithDefaultPermissions

addSpace

storeSpace

addSpaceGroup

getSpaceGroup

getSpaceGroups

removeSpaceGroup

addPersonalSpace

addPersonalSpaceWithDefaultPermissions

removeSpace

getSpace

getSpaceStatus

setSpaceStatus

getPermissions

getPermissionsForUser

getSpacePermissionSets

getSpacePermissionSet

addPermissionToSpace

addPermissionsToSpace

removePermissionFromSpace

addAnonymousPermissionToSpace

addAnonymousPermissionsToSpace

removeAnonymousPermissionFromSpace

getPagePermissions

getSpaceLevelPermissions

getPages

getPage

getPageSummary

getPage

getPageSummary

storePage

updatePage

movePageToTopLevel

movePage

removePage

removePageVersionById

removePageVersionByVersion

getTrashContents

purgeFromTrash

emptyTrash

getTopLevelPages

getAncestors

getChildren

getDescendents

getAttachments

getPageHistory

watchPage

watchSpace

watchPageForUser

removePageWatch

removeSpaceWatch

removePageWatchForUser

isWatchingPage

isWatchingSpace

isWatchingSpaceForType

getWatchersForPage

getWatchersForSpace

renderContent

renderContent

convertWikiToStorageFormat

addAttachment

addAttachment

getAttachment

getAttachmentData

removeAttachment

moveAttachment

getComments