{"openapi":"3.1.0","info":{"title":"Orbb API","version":"1.0.0"},"servers":[{"url":"https://api.orbb.app"}],"paths":{"/v1/tools/search_bookmarks":{"post":{"operationId":"search_bookmarks","summary":"Search Bookmarks","description":"Search the user's Orbb saves by keyword, category, type, platform, or saved date.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","maxLength":500},"category":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":120},"platform":{"type":"string","maxLength":120},"dateFrom":{"type":"string","maxLength":32},"dateTo":{"type":"string","maxLength":32},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"includeMedia":{"default":false,"type":"boolean"}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/search_evidence_chunks":{"post":{"operationId":"search_evidence_chunks","summary":"Search Evidence Chunks","description":"Search exact saved passages, transcript segments, recipes, itineraries, locations, and other grounded evidence.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500},"category":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":120},"dateFrom":{"type":"string","maxLength":32},"limit":{"default":12,"type":"integer","minimum":1,"maximum":30},"includeMedia":{"default":false,"type":"boolean"}},"required":["query"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_bookmark":{"post":{"operationId":"get_bookmark","summary":"Get Bookmark","description":"Get one owned bookmark with its saved details and extracted context.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bookmarkId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"includeMedia":{"default":false,"type":"boolean"}},"required":["bookmarkId"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_plans":{"post":{"operationId":"get_plans","summary":"Get Plans","description":"List the user's Orbb plans, including their source bookmarks and generated content.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_picks":{"post":{"operationId":"get_picks","summary":"Get Picks","description":"List the user's curated Orbb picks and their saved bookmark IDs.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":50,"type":"integer","minimum":1,"maximum":50}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_insights":{"post":{"operationId":"get_insights","summary":"Get Insights","description":"Get counts, streaks, categories, resources, locations, and entities derived from the user's saves.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_resources":{"post":{"operationId":"get_resources","summary":"Get Resources","description":"Get the actual extracted movies, TV shows, books, songs, places, products, recipes, albums, apps, and other resource entities mentioned in saves. Use these resource IDs—not source bookmark IDs—when the user wants a collection of the things themselves.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","maxLength":120},"limit":{"default":30,"type":"integer","minimum":1,"maximum":50}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_bookmarks_by_entity":{"post":{"operationId":"get_bookmarks_by_entity","summary":"Get Bookmarks by Entity","description":"Find saves mentioning a specific person, organization, place, or topic.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"entityType":{"type":"string","enum":["people","organizations","places","topics"]},"entityName":{"type":"string","minLength":1,"maxLength":200},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"includeMedia":{"default":false,"type":"boolean"}},"required":["entityType","entityName"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_constellation":{"post":{"operationId":"get_constellation","summary":"Get Constellation","description":"Build a compact knowledge graph of saved categories connected by shared topics.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_memories":{"post":{"operationId":"get_memories","summary":"Get Orbb Memories","description":"Get durable preferences and context Orbb has learned from prior conversations.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_recent_bookmarks":{"post":{"operationId":"get_recent_bookmarks","summary":"Get Recent Bookmarks","description":"Browse the user's newest saves without needing a search query.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":249},"category":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":120},"platform":{"type":"string","maxLength":120},"includeMedia":{"default":false,"type":"boolean"}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_categories":{"post":{"operationId":"get_categories","summary":"Get Categories","description":"List saved categories with counts and their most common tags.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_bookmarks_batch":{"post":{"operationId":"get_bookmarks_batch","summary":"Get Bookmarks Batch","description":"Retrieve up to 50 owned bookmarks by ID in one call.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bookmarkIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"includeMedia":{"default":false,"type":"boolean"}},"required":["bookmarkIds"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_related_bookmarks":{"post":{"operationId":"get_related_bookmarks","summary":"Get Related Bookmarks","description":"Find current related saves using live evidence, canonical resources, entities, tags, and semantic similarity.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bookmarkId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"limit":{"default":10,"type":"integer","minimum":1,"maximum":20},"includeMedia":{"default":false,"type":"boolean"}},"required":["bookmarkId"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_user_profile":{"post":{"operationId":"get_user_profile","summary":"Get User Profile","description":"Get the user's Orbb profile plus derived interests, platforms, topics, locations, and collection counts.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/synthesize_bookmarks":{"post":{"operationId":"synthesize_bookmarks","summary":"Synthesize Bookmarks","description":"Reason across grounded saved evidence to find themes, knowledge gaps, comparisons, or surprising connections.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500},"bookmarkIds":{"maxItems":30,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"category":{"type":"string","maxLength":120},"synthesisType":{"default":"themes","type":"string","enum":["themes","knowledge_gaps","connections","comparison"]},"limit":{"default":15,"type":"integer","minimum":2,"maximum":30},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/rediscover_bookmarks":{"post":{"operationId":"rediscover_bookmarks","summary":"Rediscover Bookmarks","description":"Surface older saves that are relevant to a current interest or to the user's strongest saved topics.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"context":{"type":"string","maxLength":500},"limit":{"default":5,"type":"integer","minimum":1,"maximum":10},"includeMedia":{"default":false,"type":"boolean"}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_today_day_dump":{"post":{"operationId":"get_today_day_dump","summary":"Get Today's Day Dump","description":"Read only the user's Day Dump for today in their current IANA timezone. This tool cannot access historical dates.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"default":"UTC","type":"string","minLength":1,"maxLength":120}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/add_to_today_day_dump":{"post":{"operationId":"add_to_today_day_dump","summary":"Add to Today's Day Dump","description":"Add a text note or URL to today's Day Dump only. Set confirmed=true only after the user approves the write.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"default":"UTC","type":"string","minLength":1,"maxLength":120},"kind":{"type":"string","enum":["text","url"]},"title":{"type":"string","maxLength":240},"subtitle":{"type":"string","maxLength":120},"text":{"type":"string","maxLength":20000},"url":{"type":"string","maxLength":2000,"format":"uri"},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["kind","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/remove_from_today_day_dump":{"post":{"operationId":"remove_from_today_day_dump","summary":"Remove from Today's Day Dump","description":"Remove one entry from today's Day Dump only. The underlying bookmark or media is not deleted. Requires explicit user confirmation.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"default":"UTC","type":"string","minLength":1,"maxLength":120},"entryId":{"type":"string","minLength":1,"maxLength":160},"confirmed":{"type":"boolean"}},"required":["entryId","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/list_collections":{"post":{"operationId":"list_collections","summary":"List Custom Collections","description":"List the user's custom collections and current optimistic versions before organizing them.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/get_collection":{"post":{"operationId":"get_collection","summary":"Get Custom Collection","description":"Get one custom collection and all of its bookmark and extracted-resource memberships.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"itemLimit":{"default":50,"type":"integer","minimum":1,"maximum":100}},"required":["collectionId"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/create_collection":{"post":{"operationId":"create_collection","summary":"Create Custom Collection","description":"Create a manual custom collection. Set confirmed=true only after the user approves the write.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":2000},"icon":{"type":"string","maxLength":80},"color":{"type":"string","maxLength":80},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["name","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/add_bookmarks_to_collection":{"post":{"operationId":"add_bookmarks_to_collection","summary":"Add Bookmarks to Collection","description":"Add source bookmark posts or saved pages to a manual collection. Do not use this when the user asks for a collection of movies, shows, books, songs, places, recipes, products, or other extracted things; use add_resources_to_collection instead.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bookmarkIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reason":{"type":"string","maxLength":1000},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["collectionId","expectedVersion","bookmarkIds","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/add_resources_to_collection":{"post":{"operationId":"add_resources_to_collection","summary":"Add Resources to Collection","description":"Add actual extracted resource entities—such as movies, TV shows, books, songs, places, recipes, or products—to a manual collection. Obtain IDs from get_resources, use the collection's current version, and set confirmed=true only after approval.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"resourceItemIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reason":{"type":"string","maxLength":1000},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["collectionId","expectedVersion","resourceItemIds","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/remove_bookmarks_from_collection":{"post":{"operationId":"remove_bookmarks_from_collection","summary":"Remove Bookmarks from Collection","description":"Remove memberships from a collection without deleting the underlying bookmarks. Requires confirmation and the current version.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bookmarkIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reason":{"type":"string","maxLength":1000},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["collectionId","expectedVersion","bookmarkIds","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/remove_resources_from_collection":{"post":{"operationId":"remove_resources_from_collection","summary":"Remove Resources from Collection","description":"Remove extracted resource memberships from a collection without deleting either the resource or its source bookmarks. Requires confirmation and the collection's current version.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"resourceItemIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reason":{"type":"string","maxLength":1000},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["collectionId","expectedVersion","resourceItemIds","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}},"/v1/tools/move_bookmarks_between_collections":{"post":{"operationId":"move_bookmarks_between_collections","summary":"Move Bookmarks Between Collections","description":"Atomically add bookmarks to a target collection and remove them from the source. Requires confirmation and both current versions.","security":[{"apiKeyBearer":[]},{"oauth2":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceCollectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetCollectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedSourceVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expectedTargetVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"bookmarkIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reason":{"type":"string","maxLength":1000},"confirmed":{"type":"boolean"},"operationKey":{"type":"string","minLength":8,"maxLength":120}},"required":["sourceCollectionId","targetCollectionId","expectedSourceVersion","expectedTargetVersion","bookmarkIds","confirmed"],"$schema":"http://json-schema.org/draft-07/schema#"}}}},"responses":{"200":{"description":"Successful Orbb MCP-equivalent tool result"}}}}},"components":{"securitySchemes":{"apiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"Orbb API key"},"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://www.orbb.app/authorize","tokenUrl":"https://www.orbb.app/token","scopes":{"orbb:read":"Read and search Orbb data","orbb:write":"Create and organize Orbb data","orbb:ai":"Use AI synthesis tools"}}}}}}}