Folders

Create a folder

This route allows you to create a folder in a sidebar. Folders let you organize pages in your platform's navigation.<br/><br/>To learn more about folders, check out the documentation.

post/v1/sidebars/{sidebar_identifier}/folders

Request

  • Base URL: https://api.port.io
  • URL: https://api.port.io/v1/sidebars/{sidebar_identifier}/folders
  • Auth: API key in header Authorization

Path parameters

sidebar_identifier'catalog' required

The identifier of the sidebar. Currently only catalog is supported.

Request body

identifierstring required

The unique identifier of the folder.

titlestring required

The display title of the folder.

iconstring nullable

The display icon of the folder.

parentstring nullable

The identifier of the parent folder. Use null to place the folder at the root level of the sidebar.

afterstring nullable

The identifier of the sibling item after which this folder should appear. Use null to place the folder at the beginning of its parent.

Response

Created successfully.

okunknown required

Changes

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