{"openapi":"3.1.0","info":{"title":"Community Distributed Library","version":"0.1.0","description":"Neighbours lending each other books. Every call the website makes is here; nothing is private to it. Errors are RFC 9457 problem documents. Timestamps are Unix seconds. Personal tokens come from /connect; assistants use OAuth through the MCP server."},"servers":[{"url":"https://community-distributed-library.com/api"}],"tags":[{"name":"Catalogue"},{"name":"Shelf"},{"name":"Loans"},{"name":"Messages"},{"name":"Handoffs"},{"name":"Waitlist"},{"name":"Profile"},{"name":"Auth"},{"name":"Steward"}],"paths":{"/v1/search":{"get":{"tags":["Catalogue"],"summary":"Search copies near you by title or author","operationId":"getSearch","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"within","in":"query","required":false,"schema":{"default":2000,"type":"integer","exclusiveMinimum":0,"maximum":20000}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"state":{"type":"string","enum":["shelved","reserved","in_transit","on_loan","unavailable","lost","retired"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"available":{"type":"boolean"},"condition":{"type":"string","enum":["new","good","worn","fragile"]},"relayAllowed":{"type":"boolean"},"note":{"type":["string","null"]},"edition":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"isbn13":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}]},"title":{"type":"string","minLength":1},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","workId","isbn13","title","publisher","publishedYear","language","pageCount","coverUrl"],"additionalProperties":false},"work":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","createdAt"],"additionalProperties":false},"owner":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"area":{"type":"object","properties":{"label":{"type":"string"},"distanceM":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"approx":{"anyOf":[{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},{"type":"null"}]}},"required":["label","distanceM","approx"],"additionalProperties":false}},"required":["id","displayName","area"],"additionalProperties":false}},"required":["id","state","lending","available","condition","relayAllowed","note","edition","work","owner"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["results","total"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["catalogue:read"]},{"oauth":["catalogue:read"]}]}},"/v1/browse":{"get":{"tags":["Catalogue"],"summary":"Everything on the shelves, nearest first","operationId":"getBrowse","parameters":[{"name":"within","in":"query","required":false,"schema":{"default":5000,"type":"integer","exclusiveMinimum":0,"maximum":20000}},{"name":"limit","in":"query","required":false,"schema":{"default":24,"type":"integer","exclusiveMinimum":0,"maximum":60}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"state":{"type":"string","enum":["shelved","reserved","in_transit","on_loan","unavailable","lost","retired"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"available":{"type":"boolean"},"condition":{"type":"string","enum":["new","good","worn","fragile"]},"relayAllowed":{"type":"boolean"},"note":{"type":["string","null"]},"edition":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"isbn13":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}]},"title":{"type":"string","minLength":1},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","workId","isbn13","title","publisher","publishedYear","language","pageCount","coverUrl"],"additionalProperties":false},"work":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","createdAt"],"additionalProperties":false},"owner":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"area":{"type":"object","properties":{"label":{"type":"string"},"distanceM":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"approx":{"anyOf":[{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},{"type":"null"}]}},"required":["label","distanceM","approx"],"additionalProperties":false}},"required":["id","displayName","area"],"additionalProperties":false}},"required":["id","state","lending","available","condition","relayAllowed","note","edition","work","owner"],"additionalProperties":false}},"nextOffset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["results","nextOffset"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["catalogue:read"]},{"oauth":["catalogue:read"]}]}},"/v1/works/{id}":{"get":{"tags":["Catalogue"],"summary":"A work and the copies of it in your community","operationId":"getWorks","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"work":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","createdAt"],"additionalProperties":false},"editions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"isbn13":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}]},"title":{"type":"string","minLength":1},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","workId","isbn13","title","publisher","publishedYear","language","pageCount","coverUrl"],"additionalProperties":false}},"copies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"state":{"type":"string","enum":["shelved","reserved","in_transit","on_loan","unavailable","lost","retired"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"available":{"type":"boolean"},"condition":{"type":"string","enum":["new","good","worn","fragile"]},"relayAllowed":{"type":"boolean"},"note":{"type":["string","null"]},"edition":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"isbn13":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}]},"title":{"type":"string","minLength":1},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","workId","isbn13","title","publisher","publishedYear","language","pageCount","coverUrl"],"additionalProperties":false},"work":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","createdAt"],"additionalProperties":false},"owner":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"area":{"type":"object","properties":{"label":{"type":"string"},"distanceM":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"approx":{"anyOf":[{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"additionalProperties":false},{"type":"null"}]}},"required":["label","distanceM","approx"],"additionalProperties":false}},"required":["id","displayName","area"],"additionalProperties":false},"mine":{"type":"boolean"},"myLoanId":{"anyOf":[{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"relayable":{"type":"boolean"},"heldUntil":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","state","lending","available","condition","relayAllowed","note","edition","work","owner","mine","myLoanId","relayable","heldUntil"],"additionalProperties":false}},"myWaitlist":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","position"],"additionalProperties":false},{"type":"null"}]}},"required":["work","editions","copies","myWaitlist"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["catalogue:read"]},{"oauth":["catalogue:read"]}]}},"/v1/lookup/{isbn}":{"get":{"tags":["Catalogue"],"summary":"Book metadata for an ISBN-13 from the public providers","operationId":"getLookup","parameters":[{"name":"isbn","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"isbn13":{"type":"string","pattern":"^\\d{13}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"source":{"type":"string","enum":["openlibrary","googlebooks"]}},"required":["isbn13","title","authors","publisher","publishedYear","language","pageCount","coverUrl","source"],"additionalProperties":false},{"type":"null"}]}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["catalogue:read"]},{"oauth":["catalogue:read"]}]}},"/v1/works/{id}/card":{"get":{"tags":["Catalogue"],"summary":"Public card for link previews: title, authors, cover, counts","operationId":"getWorksCard","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"isbn13":{"type":["string","null"]},"copies":{"type":"integer","minimum":0,"maximum":9007199254740991},"waiting":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","coverUrl","isbn13","copies","waiting"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[]}},"/v1/wanted":{"get":{"tags":["Catalogue"],"summary":"Books neighbours are waiting for that nobody has listed","operationId":"getWanted","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"works":{"type":"array","items":{"type":"object","properties":{"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"isbn13":{"type":["string","null"]},"waiting":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["workId","title","authors","coverUrl","isbn13","waiting"],"additionalProperties":false}}},"required":["works"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["catalogue:read"]},{"oauth":["catalogue:read"]}]},"post":{"tags":["Catalogue"],"summary":"Ask for a book nobody has listed; joins its waitlist","operationId":"postWanted","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"isbn13":{"type":"string","pattern":"^\\d{13}$"},"title":{"type":"string","minLength":1,"maxLength":200},"authors":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["workId","position"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/me/shelf":{"get":{"tags":["Shelf"],"summary":"Your copies","operationId":"getMeShelf","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"copies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"state":{"type":"string","enum":["shelved","reserved","in_transit","on_loan","unavailable","lost","retired"]},"condition":{"type":"string","enum":["new","good","worn","fragile"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"relayAllowed":{"type":"boolean"},"note":{"type":["string","null"]},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]}},"required":["id","state","condition","lending","relayAllowed","note","title","authors","coverUrl"],"additionalProperties":false}}},"required":["copies"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:read"]},{"oauth":["shelf:read"]}]}},"/v1/copies":{"post":{"tags":["Shelf"],"summary":"List a copy you own","operationId":"postCopies","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"isbn13":{"type":"string","pattern":"^\\d{13}$"},"manual":{"type":"object","properties":{"title":{"type":"string","minLength":1},"authors":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"language":{"type":"string"},"coverUrl":{"type":"string","format":"uri"}},"required":["title","authors"]},"condition":{"default":"good","type":"string","enum":["new","good","worn","fragile"]},"lending":{"default":"lendable","type":"string","enum":["lendable","reference","paused"]},"relayAllowed":{"default":true,"type":"boolean"},"loanDays":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"note":{"type":"string","maxLength":280}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"editionId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["id","editionId","workId"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:write"]},{"oauth":["shelf:write"]}]}},"/v1/copies/{id}":{"get":{"tags":["Shelf"],"summary":"One of your copies, for editing","operationId":"getCopies","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"state":{"type":"string","enum":["shelved","reserved","in_transit","on_loan","unavailable","lost","retired"]},"condition":{"type":"string","enum":["new","good","worn","fragile"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"relayAllowed":{"type":"boolean"},"loanDays":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"note":{"type":["string","null"]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"edition":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"isbn13":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}]},"title":{"type":"string","minLength":1},"publisher":{"type":["string","null"]},"publishedYear":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language":{"type":["string","null"]},"pageCount":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","workId","isbn13","title","publisher","publishedYear","language","pageCount","coverUrl"],"additionalProperties":false},"work":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string","minLength":1},"authors":{"type":"array","items":{"type":"string","minLength":1}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","createdAt"],"additionalProperties":false},"editable":{"type":"object","properties":{"details":{"type":"boolean"}},"required":["details"],"additionalProperties":false},"openLoan":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string"}},"required":["id","status"],"additionalProperties":false},{"type":"null"}]}},"required":["id","state","condition","lending","relayAllowed","loanDays","note","createdAt","edition","work","editable","openLoan"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:read"]},{"oauth":["shelf:read"]}]},"patch":{"tags":["Shelf"],"summary":"Edit a copy's condition, note, cover or lending policy","operationId":"patchCopies","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"condition":{"type":"string","enum":["new","good","worn","fragile"]},"lending":{"type":"string","enum":["lendable","reference","paused"]},"relayAllowed":{"type":"boolean"},"loanDays":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":90},{"type":"null"}]},"note":{"anyOf":[{"type":"string","maxLength":280},{"type":"null"}]},"coverUrl":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"authors":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}}}}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:write"]},{"oauth":["shelf:write"]}]},"delete":{"tags":["Shelf"],"summary":"Take a copy off the shelves","operationId":"deleteCopies","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:write"]},{"oauth":["shelf:write"]}]}},"/v1/covers":{"post":{"tags":["Shelf"],"summary":"Upload a cover image (multipart field `file`, JPEG/PNG/WebP, cropped client-side)","operationId":"postCovers","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"coverUrl":{"type":"string","format":"uri"}},"required":["coverUrl"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:write"]},{"oauth":["shelf:write"]}]}},"/v1/covers/from-url":{"post":{"tags":["Shelf"],"summary":"Fetch a cover from a public URL into the library's storage","operationId":"postCoversFromUrl","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"}},"required":["url"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"coverUrl":{"type":"string","format":"uri"}},"required":["coverUrl"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["shelf:write"]},{"oauth":["shelf:write"]}]}},"/v1/me/loans":{"get":{"tags":["Loans"],"summary":"Loans you are borrowing, lending, passing on or waiting for","operationId":"getMeLoans","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"borrowing":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","enum":["requested","accepted","declined","active","completed","cancelled","lost"]},"message":{"type":["string","null"]},"requestedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"decidedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"dueAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"closedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"nudgeCooldown":{"type":"integer","minimum":0,"maximum":9007199254740991},"extensions":{"type":"integer","minimum":0,"maximum":9007199254740991},"someoneWaiting":{"type":"boolean"},"copy":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"condition":{"type":"string","enum":["new","good","worn","fragile"]}},"required":["id","title","authors","coverUrl","condition"],"additionalProperties":false},"borrower":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"lender":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"relayFrom":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","message","requestedAt","decidedAt","startedAt","dueAt","closedAt","nudgeCooldown","extensions","someoneWaiting","copy","borrower","lender","relayFrom"],"additionalProperties":false}},"lending":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","enum":["requested","accepted","declined","active","completed","cancelled","lost"]},"message":{"type":["string","null"]},"requestedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"decidedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"dueAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"closedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"nudgeCooldown":{"type":"integer","minimum":0,"maximum":9007199254740991},"extensions":{"type":"integer","minimum":0,"maximum":9007199254740991},"someoneWaiting":{"type":"boolean"},"copy":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"condition":{"type":"string","enum":["new","good","worn","fragile"]}},"required":["id","title","authors","coverUrl","condition"],"additionalProperties":false},"borrower":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"lender":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"relayFrom":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","message","requestedAt","decidedAt","startedAt","dueAt","closedAt","nudgeCooldown","extensions","someoneWaiting","copy","borrower","lender","relayFrom"],"additionalProperties":false}},"relaying":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","enum":["requested","accepted","declined","active","completed","cancelled","lost"]},"message":{"type":["string","null"]},"requestedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"decidedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"dueAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"closedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"nudgeCooldown":{"type":"integer","minimum":0,"maximum":9007199254740991},"extensions":{"type":"integer","minimum":0,"maximum":9007199254740991},"someoneWaiting":{"type":"boolean"},"copy":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"condition":{"type":"string","enum":["new","good","worn","fragile"]}},"required":["id","title","authors","coverUrl","condition"],"additionalProperties":false},"borrower":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"lender":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]}},"required":["id","displayName","areaLabel"],"additionalProperties":false},"relayFrom":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},{"type":"null"}]}},"required":["id","status","message","requestedAt","decidedAt","startedAt","dueAt","closedAt","nudgeCooldown","extensions","someoneWaiting","copy","borrower","lender","relayFrom"],"additionalProperties":false}}},"required":["borrowing","lending","relaying"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:read"]},{"oauth":["loans:read"]}]}},"/v1/loans":{"post":{"tags":["Loans"],"summary":"Ask to borrow a copy (or to be next, when the holder may relay)","operationId":"postLoans","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"copyId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"message":{"type":"string","maxLength":280}},"required":["copyId"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","enum":["requested","accepted","declined","active","completed","cancelled","lost"]},"relay":{"type":"boolean"}},"required":["id","status","relay"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/accept":{"post":{"tags":["Loans"],"summary":"Owner accepts a request","operationId":"postLoansAccept","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/decline":{"post":{"tags":["Loans"],"summary":"Owner declines a request","operationId":"postLoansDecline","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/cancel":{"post":{"tags":["Loans"],"summary":"Withdraw a request or an accepted loan before handoff","operationId":"postLoansCancel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/handed":{"post":{"tags":["Loans"],"summary":"Giver marks the book handed over","operationId":"postLoansHanded","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/returned":{"post":{"tags":["Loans"],"summary":"Owner marks the book back on the shelf","operationId":"postLoansReturned","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/extend":{"post":{"tags":["Loans"],"summary":"Push the due date back; borrowers only when nobody waits","operationId":"postLoansExtend","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"days":{"default":7,"type":"integer","minimum":1,"maximum":21}}}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/nudge":{"post":{"tags":["Loans"],"summary":"Gentle reminder to the other party, once a day","operationId":"postLoansNudge","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/report":{"post":{"tags":["Loans"],"summary":"Report damage, loss, a no-show or conduct to the stewards","operationId":"postLoansReport","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["damage","loss","no_show","conduct","other"]},"body":{"type":"string","maxLength":1000}},"required":["kind"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["id"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/messages":{"get":{"tags":["Messages"],"summary":"The loan's conversation","operationId":"getLoansMessages","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"loanId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"viewerId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"participants":{"type":"object","propertyNames":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"additionalProperties":{"type":"string"}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"loanId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"authorId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"body":{"type":"string","minLength":1,"maxLength":1000},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","loanId","authorId","body","createdAt"],"additionalProperties":false}},"open":{"type":"boolean"}},"required":["loanId","viewerId","participants","messages","open"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["messages:read"]},{"oauth":["messages:read"]}]},"post":{"tags":["Messages"],"summary":"Post to the loan's conversation","operationId":"postLoansMessages","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":1000}},"required":["body"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"loanId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"authorId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"body":{"type":"string","minLength":1,"maxLength":1000},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","loanId","authorId","body","createdAt"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["messages:write"]},{"oauth":["messages:write"]}]}},"/v1/me/availability":{"get":{"tags":["Handoffs"],"summary":"Your weekly availability grid","operationId":"getMeAvailability","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"slots":{"maxItems":21,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"period":{"type":"string","enum":["morning","afternoon","evening"]}},"required":["weekday","period"],"additionalProperties":false}},"meetingPlace":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]}},"required":["slots","meetingPlace"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["profile:read"]},{"oauth":["profile:read"]}]},"put":{"tags":["Handoffs"],"summary":"Replace your availability grid","operationId":"putMeAvailability","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slots":{"maxItems":21,"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6},"period":{"type":"string","enum":["morning","afternoon","evening"]}},"required":["weekday","period"]}},"meetingPlace":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]}},"required":["slots","meetingPlace"]}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/loans/{id}/slots":{"get":{"tags":["Handoffs"],"summary":"Times both sides are free in the coming days","operationId":"getLoansSlots","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"options":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"period":{"type":"string","enum":["morning","afternoon","evening"]},"both":{"type":"boolean"}},"required":["day","period","both"],"additionalProperties":false}},"theirGridEmpty":{"type":"boolean"}},"required":["options","theirGridEmpty"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:read"]},{"oauth":["loans:read"]}]}},"/v1/loans/{id}/handoff":{"get":{"tags":["Handoffs"],"summary":"The current handoff, if any","operationId":"getLoansHandoff","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"handoff":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"direction":{"type":"string","enum":["out","back"]},"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"period":{"type":"string","enum":["morning","afternoon","evening"]},"status":{"type":"string","enum":["proposed","agreed","completed","cancelled"]},"proposedByMe":{"type":"boolean"},"place":{"type":["string","null"]},"code":{"type":["string","null"]},"agreedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","direction","day","period","status","proposedByMe","place","code","agreedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["handoff"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:read"]},{"oauth":["loans:read"]}]}},"/v1/loans/{id}/handoff/propose":{"post":{"tags":["Handoffs"],"summary":"Propose a day and period","operationId":"postLoansHandoffPropose","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"period":{"type":"string","enum":["morning","afternoon","evening"]}},"required":["day","period"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","const":"proposed"}},"required":["id","status"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/handoff/confirm":{"post":{"tags":["Handoffs"],"summary":"Agree to the proposed time; the meeting place is revealed","operationId":"postLoansHandoffConfirm","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/handoff/cancel":{"post":{"tags":["Handoffs"],"summary":"Call the proposed time off","operationId":"postLoansHandoffCancel","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/loans/{id}/handoff/complete":{"post":{"tags":["Handoffs"],"summary":"Confirm the handoff with the other side's code","operationId":"postLoansHandoffComplete","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":4,"maxLength":12}},"required":["code"]}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/me/waitlist":{"get":{"tags":["Waitlist"],"summary":"Books you are waiting for","operationId":"getMeWaitlist","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"offer":{"anyOf":[{"type":"object","properties":{"copyId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["copyId","expiresAt"],"additionalProperties":false},{"type":"null"}]}},"required":["id","workId","title","authors","coverUrl","position","createdAt","offer"],"additionalProperties":false}}},"required":["entries"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:read"]},{"oauth":["loans:read"]}]}},"/v1/waitlist":{"post":{"tags":["Waitlist"],"summary":"Wait for the next free copy of a work","operationId":"postWaitlist","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"workId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["workId"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","position"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/waitlist/{id}":{"delete":{"tags":["Waitlist"],"summary":"Stop waiting","operationId":"deleteWaitlist","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:write"]},{"oauth":["loans:write"]}]}},"/v1/me":{"get":{"tags":["Profile"],"summary":"Who you are, your community and area","operationId":"getMe","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"email":{},"displayName":{"type":"string"},"locale":{"type":"string","enum":["en","he"]},"area":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"}},"required":["label","lat","lng"],"additionalProperties":false},{"type":"null"}]},"communityId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"community":{"type":"object","properties":{"name":{"type":"string"},"centre":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"],"additionalProperties":false},"radiusM":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["name","centre","radiusM"],"additionalProperties":false},"role":{"type":"string","enum":["member","steward"]}},"required":["id","email","displayName","locale","area","communityId","community","role"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["profile:read"]},{"oauth":["profile:read"]}]},"patch":{"tags":["Profile"],"summary":"Update your name, locale or area","operationId":"patchMe","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":60},"locale":{"type":"string","enum":["en","he"]},"area":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":60},"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["label","lat","lng"]}}}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/me/tokens":{"get":{"tags":["Profile"],"summary":"Connected apps and personal tokens","operationId":"getMeTokens","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"clientName":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["catalogue:read","shelf:read","shelf:write","loans:read","loans:write","messages:read","messages:write","profile:read","admin"]}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastUsedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","clientName","scopes","createdAt","lastUsedAt","expiresAt"],"additionalProperties":false}}},"required":["tokens"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."},"post":{"tags":["Profile"],"summary":"Create a personal token (shown once)","operationId":"postMeTokens","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clientName":{"type":"string","minLength":1,"maxLength":80},"scopes":{"minItems":1,"type":"array","items":{"type":"string","enum":["catalogue:read","shelf:read","shelf:write","loans:read","loans:write","messages:read","messages:write","profile:read","admin"]}}},"required":["clientName","scopes"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"token":{"type":"string"},"clientName":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["catalogue:read","shelf:read","shelf:write","loans:read","loans:write","messages:read","messages:write","profile:read","admin"]}},"expiresAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","token","clientName","scopes","expiresAt"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/me/tokens/{id}":{"delete":{"tags":["Profile"],"summary":"Revoke a token","operationId":"deleteMeTokens","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/events":{"get":{"tags":["Webhooks"],"summary":"Replay events you may see, oldest first from a cursor","operationId":"getEvents","parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"kind":{"type":"string"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","kind","data","createdAt"],"additionalProperties":false}},"next":{"anyOf":[{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]}},"required":["events","next"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["loans:read"]},{"oauth":["loans:read"]}]}},"/v1/me/webhooks":{"get":{"tags":["Webhooks"],"summary":"Your subscriptions","operationId":"getMeWebhooks","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"webhooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"url":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["copy.listed","copy.retired","copy.state_changed","loan.requested","loan.accepted","handoff.scheduled","handoff.confirmed","loan.closed"]}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastStatus":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","url","kinds","createdAt","disabledAt","failures","lastStatus","lastAt"],"additionalProperties":false}}},"required":["webhooks"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."},"post":{"tags":["Webhooks"],"summary":"Subscribe an HTTPS URL; the signing secret is returned once","operationId":"postMeWebhooks","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"kinds":{"default":[],"type":"array","items":{"type":"string","enum":["copy.listed","copy.retired","copy.state_changed","loan.requested","loan.accepted","handoff.scheduled","handoff.confirmed","loan.closed"]}}},"required":["url"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"url":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["copy.listed","copy.retired","copy.state_changed","loan.requested","loan.accepted","handoff.scheduled","handoff.confirmed","loan.closed"]}},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"failures":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastStatus":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"secret":{"type":"string"}},"required":["id","url","kinds","createdAt","disabledAt","failures","lastStatus","lastAt","secret"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/me/webhooks/{id}":{"delete":{"tags":["Webhooks"],"summary":"Remove a subscription","operationId":"deleteMeWebhooks","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/me/webhooks/{id}/test":{"post":{"tags":["Webhooks"],"summary":"Send a signed `ping` now","operationId":"postMeWebhooksTest","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ok":{"type":"boolean"}},"required":["status","ok"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/me/webhooks/{id}/deliveries":{"get":{"tags":["Webhooks"],"summary":"Recent deliveries and their outcomes","operationId":"getMeWebhooksDeliveries","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"eventId":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"kind":{"type":"string"},"status":{"type":"string","enum":["pending","delivered","failed"]},"attempts":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastStatus":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastError":{"type":["string","null"]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","eventId","kind","status","attempts","nextAt","lastStatus","lastError","createdAt"],"additionalProperties":false}}},"required":["deliveries"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/auth/magic-link":{"post":{"tags":["Auth"],"summary":"Email a sign-in link to a member or invitee","operationId":"postAuthMagicLink","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"invite":{"type":"string","minLength":16,"maxLength":128},"locale":{"default":"en","type":"string","enum":["en","he"]}},"required":["email"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"debugUrl":{"type":"string","format":"uri"},"debugReason":{"type":"string","enum":["unknown_email"]}},"required":["ok"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[]}},"/v1/auth/logout":{"post":{"tags":["Auth"],"summary":"End the session","operationId":"postAuthLogout","responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":[]}],"x-session-only":true,"description":"Browser sessions only: a personal token cannot call this."}},"/v1/invites":{"post":{"tags":["Auth"],"summary":"Steward creates an invite link","operationId":"postInvites","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"maxUses":{"default":1,"type":"integer","minimum":1,"maximum":50},"days":{"default":7,"type":"integer","minimum":1,"maximum":30}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"token":{"type":"string"},"url":{"type":"string","format":"uri"},"maxUses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","token","url","maxUses","expiresAt"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/stats":{"get":{"tags":["Steward"],"summary":"Community counts","operationId":"getAdminStats","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"members":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stewards":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lendable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"activeInvites":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["name","members","stewards","copies","lendable","activeInvites"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/attention":{"get":{"tags":["Steward"],"summary":"Open reports, overdue loans, unanswered requests","operationId":"getAdminAttention","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"loanId":{"anyOf":[{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"kind":{"type":"string","enum":["overdue","unanswered","report"]},"reportId":{"anyOf":[{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},{"type":"null"}]},"reportKind":{"type":["string","null"]},"body":{"type":["string","null"]},"bookTitle":{"type":"string"},"borrowerName":{"type":"string"},"lenderName":{"type":"string"},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["loanId","kind","reportId","reportKind","body","bookTitle","borrowerName","lenderName","days"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/members":{"get":{"tags":["Steward"],"summary":"Members and their roles","operationId":"getAdminMembers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"email":{},"displayName":{"type":"string"},"areaLabel":{"type":["string","null"]},"role":{"type":"string","enum":["member","steward"]},"status":{"type":"string","enum":["pending","active","suspended","left"]},"copies":{"type":"integer","minimum":0,"maximum":9007199254740991},"joinedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastSeenAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","email","displayName","areaLabel","role","status","copies","joinedAt","lastSeenAt"],"additionalProperties":false}}},"required":["members"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/members/{id}/role":{"post":{"tags":["Steward"],"summary":"Make or remove a steward","operationId":"postAdminMembersRole","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string","enum":["member","steward"]}},"required":["role"]}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/members/{id}/status":{"post":{"tags":["Steward"],"summary":"Pause or reactivate a member","operationId":"postAdminMembersStatus","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","suspended"]}},"required":["status"]}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/copies":{"get":{"tags":["Steward"],"summary":"Every copy in the community","operationId":"getAdminCopies","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"copies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"title":{"type":"string"},"authors":{"type":"array","items":{"type":"string"}},"coverUrl":{"type":["string","null"]},"state":{"type":"string"},"lending":{"type":"string"},"owner":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},"openLoan":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string"},"borrowerName":{"type":"string"}},"required":["id","status","borrowerName"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","title","authors","coverUrl","state","lending","owner","openLoan","createdAt"],"additionalProperties":false}}},"required":["copies"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/copies/{id}/retire":{"post":{"tags":["Steward"],"summary":"Retire a copy","operationId":"postAdminCopiesRetire","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/invites":{"get":{"tags":["Steward"],"summary":"Open invites","operationId":"getAdminInvites","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"invites":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"createdBy":{"type":"string"},"maxUses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"uses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","createdBy","maxUses","uses","expiresAt","createdAt","revokedAt"],"additionalProperties":false}}},"required":["invites"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]},"post":{"tags":["Steward"],"summary":"Create an invite link","operationId":"postAdminInvites","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"maxUses":{"default":1,"type":"integer","minimum":1,"maximum":50},"days":{"default":7,"type":"integer","minimum":1,"maximum":30}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"token":{"type":"string"},"url":{"type":"string","format":"uri"},"maxUses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","token","url","maxUses","expiresAt"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/invites/{id}/revoke":{"post":{"tags":["Steward"],"summary":"Revoke an invite","operationId":"postAdminInvitesRevoke","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/reports":{"get":{"tags":["Steward"],"summary":"Reports, open first","operationId":"getAdminReports","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"reports":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"kind":{"type":"string","enum":["damage","loss","no_show","conduct","other"]},"body":{"type":["string","null"]},"status":{"type":"string","enum":["open","resolved","dismissed"]},"resolution":{"type":["string","null"]},"reporter":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},"subject":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"displayName":{"type":"string"}},"required":["id","displayName"],"additionalProperties":false},{"type":"null"}]},"loan":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9A-HJKMNP-TV-Z]{26}$"},"bookTitle":{"type":"string"}},"required":["id","bookTitle"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"closedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","kind","body","status","resolution","reporter","subject","loan","createdAt","closedAt"],"additionalProperties":false}}},"required":["reports"],"additionalProperties":false}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/reports/{id}/resolve":{"post":{"tags":["Steward"],"summary":"Close a report as handled","operationId":"postAdminReportsResolve","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resolution":{"type":"string","maxLength":500}}}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/reports/{id}/dismiss":{"post":{"tags":["Steward"],"summary":"Close a report as not needed (a dismissed loss reshelves the copy)","operationId":"postAdminReportsDismiss","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resolution":{"type":"string","maxLength":500}}}}}},"responses":{"204":{"description":"Done"},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}},"/v1/admin/reminders/run":{"post":{"tags":["Steward"],"summary":"Run the daily reminder pass now","operationId":"postAdminRemindersRun","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"at":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["at"],"additionalProperties":{}}}}},"4XX":{"description":"Problem","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"default":"about:blank","type":"string"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"],"additionalProperties":false}}},"required":["type","title","status"],"additionalProperties":false}}}}},"security":[{"bearer":["admin"]},{"oauth":["admin"]}]}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A personal token or a session token, with the listed scope."},"oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://mcp.community-distributed-library.com/authorize","tokenUrl":"https://mcp.community-distributed-library.com/token","scopes":{"catalogue:read":"Browse and search the shelves","shelf:read":"See your books","shelf:write":"Add and edit your books","loans:read":"See your loans","loans:write":"Request books and answer requests","messages:read":"Read loan conversations","messages:write":"Send messages on loans","profile:read":"See your name and area","admin":"Steward actions"}}}}}}}