ackDB

Reorder the caller's segment folders

Rewrites every folder's position from the given order, in one transaction. folderIds must name the caller's COMPLETE set exactly once: a partial list has no defined meaning for the folders left out, and silently appending them produces a rail that reshuffles itself. On a mismatch nothing is reordered and the 400 body reports the difference under error.details.errors.folderIds as { missing, unknown }.

put/api/v1/ackdb/observe/segment-folders/reorder

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Request body

folderIdsstring[] required

Response

The caller's folders in their new order.

Example response

{
  "data": [
    {
      "id": "01JA0B1C2D3E4F5G6H7J8K9M0N",
      "name": "Q3 Enterprise Push",
      "ownerEmail": "rep@acme.com",
      "segmentCount": 4
    }
  ]
}

Changes

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