Save a block to the library
POST/v1/library/entries
Saves one block of a trip — and everything inside it — as a reusable library entry (Catalog → Blocks), as Save to library does. The trip is read as it is now. Needs trips:read as well. Undo with POST /changes/{changeId}/revert, while nobody has edited the entry since.
Permissions: catalog:write, trips:read · Kind: write · Cost: 1 unit · MCP tool save_library_entry
Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.
Path parameters
None.
Body
| Field | Type | Required | Description |
|---|---|---|---|
tripId |
uuid | yes | |
blockId |
string | yes | The block's id or its short ref from get_itinerary. max 64 chars |
title |
string | yes | max 200 chars |
tags |
string[] | Replaces the tags; lowercased. max 20 items |
Response 201
| Field | Type | Required | Description |
|---|---|---|---|
object |
"library_entry" | yes | |
id |
uuid | yes | |
title |
string | yes | |
rootType |
string | yes | |
tags |
string[] | yes | |
updatedAt |
string | yes | |
snapshot |
object | 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 reachedidempotency_key_reused— Idempotency-Key reusedrequest_in_progress— Request in progress