folders

List the organization's folders.

The whole folder tree, flat (id + parentId, name-ordered) — clients assemble the hierarchy. The data array is always present (never null).

Supports conditional GET (DVT-3724): a weak, content-derived ETag and Cache-Control: private, no-cache (forces revalidation, never a shared cache) on every 200. A matching If-None-Match gets a 304 instead, with no body — the two headers are repeated on the 304 so a caller polling only that response still learns the current tag and policy.

get/v1/folders

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/folders
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Headers

If-None-Matchstring

Conditional-GET revalidation tag (DVT-3724). Compared WEAKLY against the current representation's ETag — a W/ prefix on either side is ignored (RFC 9110 §13.1.2). A comma-separated list of tags is accepted; any member matching the current tag yields 304. The wildcard * matches any current representation and always yields 304. A non-matching value gets a normal 200 with a fresh ETag.

Response

All folders in the org.

Changes

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