ATatlassian
Folder

Create folder

Creates a folder in the space.

Permissions required: Permission to view the corresponding space. Permission to create a folder in the space.

post/folders

Request

  • Base URL
    https://no-default/wiki/api/v2
  • URL
    https://no-default/wiki/api/v2/folders
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: write:folder:confluence

Request body

spaceIdstring required

ID of the space.

titlestring

Title of the folder.

parentIdstring

The parent content ID of the folder.

Response

Returned if the folder was successfully created in the content tree.

idstring

ID of the folder.

typestring

The content type of the object.

status'current' | 'draft' | 'archived' | 'historical' | 'trashed' | 'deleted' | 'any'

The status of the content.

titlestring

Title of the folder.

parentIdstring

ID of the parent content, or null if there is no parent content.

parentType'page' | 'whiteboard' | 'database' | 'embed' | 'folder'

Content type of the parent, or null if there is no parent.

positioninteger nullable

Position of the folder within the given parent page tree.

authorIdstring

The account ID of the user who created this folder.

ownerIdstring

The account ID of the user who owns this folder.

createdAtstring date-time

Date and time when the folder was created. In format "YYYY-MM-DDTHH:mm:ss.sssZ".

spaceIdstring

ID of the space the folder is in.

Changes

No recorded changes to this operation across all 5 revisions of this API.