Content

Create a folder

Requires the content.write scope.

post/folders

Request

  • Base URL: https://developer.solofire.com/v1
  • URL: https://developer.solofire.com/v1/folders
  • Auth: HTTP bearer

Query parameters

library_idstring

Only folders in this library.

configuration_idstring

Only folders reachable through this configuration (the folders attached to it and everything beneath them). With this filter, parent_folder_id=root means the folders attached directly to the configuration. Credentials acting as a rep always list this way, since reps reach content through configurations rather than libraries.

parent_folder_idstring

Only direct children of this folder. Pass root for top-level folders.

limitinteger

Page size, 1 to 200. Defaults to 50.

cursorstring

The next_cursor from a previous response.

updated_sincestring

Only records changed after this RFC 3339 timestamp. Use this to poll for changes.

Headers

Idempotency-Keystring

A unique key for this request. Retrying with the same key returns the original response instead of repeating the work. Reusing a key with a different body is rejected with 422.

Request body

namestring required

Folder name.

library_idstring

Library to create it in. Required unless parent_folder_id is given.

parent_folder_idstring

Parent folder. The new folder inherits its library.

descriptionstring

Optional description.

sort_orderinteger

Position among its siblings.

Response

Created

object required

Changes

No recorded changes to this operation across all 1 revision of this API.