ROroma
Lists

Make a sidebar section

Make, rename, delete, hide or show a sidebar section (the groups the user's lists stand in; list_lists and get_context carry them in order). create makes an empty section at the end, or answers the section that already wears the name; rename renames one (the default section too — its name is Lists until renamed; "" puts Lists back); delete removes a section and its lists return to the default section (the default section is never deleted); hide / show fold a section out of or back onto the sidebar on every device. To put a list INTO a section use create_list or update_list with section.

post/api/v1/sections

Request

  • Base URL
    https://api.roma.app
  • URL
    https://api.roma.app/api/v1/sections
  • Auth
    HTTP bearer

Request body

sectionstring nullable

The section's id or name (from list_lists); "lists" or its name for the default section. Not for create.

namestring nullable

create: the new section's name. rename: the new name ("" on the default section puts Lists back).

Response

Created; the body is the new item.

actionstring required
createdboolean

create: true when the call made the section.

releasedListIdsstring[]

delete: the lists that returned to the default section.

Changes

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