Create a document folder
POST/v1/trips/{tripId}/document-folders
Creates a folder in a trip's documents, as New folder does. File documents into it with PATCH /documents/{documentId}. Undo with POST /changes/{changeId}/revert while it is still empty.
Permissions: documents:write · Kind: write · Cost: 1 unit · MCP tool create_document_folder
Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
tripId |
uuid | yes |
Body
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | yes | As travelers will see it, e.g. 'Flights', 'Hotels', 'Insurance'. max 200 chars |
Response 201
| Field | Type | Required | Description |
|---|---|---|---|
object |
"document_folder" | yes | |
id |
uuid | yes | |
tripId |
uuid | yes | |
name |
string | yes | |
documentCount |
integer | yes | Ready documents filed in it. ≥ 0 |
createdAt |
string | yes |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reachednot_found— Not foundidempotency_key_reused— Idempotency-Key reusedrequest_in_progress— Request in progress