{"openapi":"3.1.0","info":{"title":"We Bring It Back Business API","version":"1.0.0","description":"Push found items from your own systems, keep them in sync, and react to matches and claims.\n\n**Authentication** — send your API key as `Authorization: Bearer wbib_live_…`. Keys are created by your organization's owner/admin under *Developers*, and are tied to that organization.\n\n**Rate limits** — each key has a per-minute limit (and optional daily quota). Every response carries `X-RateLimit-*` headers; when exceeded you get `429` with `Retry-After`.\n\n**Idempotency** — set `externalId` to your own id. Creating an item with an `externalId` that already exists returns the existing item, and `PUT /items/by-external/{externalId}` upserts.\n\n**Webhooks** — events are POSTed as JSON with header `X-WBIB-Signature: t=<unix>,v1=<hex>` where `v1 = HMAC_SHA256(secret, t + \".\" + rawBody)`. Reject events older than 5 minutes. Retries use exponential backoff for up to 8 attempts.\n\n**Scopes** — `items:read` (Read items), `items:write` (Create & update items, upload photos), `claims:read` (Read claims), `matches:read` (Read matches), `webhooks:manage` (Manage webhook endpoints)."},"servers":[{"url":"https://dev.webringitback.com/api/v1"}],"tags":[{"name":"Items","description":"Found/lost items owned by your organization"},{"name":"Photos","description":"Item photos"},{"name":"Claims","description":"Ownership claims submitted by visitors"},{"name":"Matches","description":"Automatic lost ↔ found matches involving your items"},{"name":"Webhooks","description":"Manage webhook endpoints"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"wbib_live_…"}},"schemas":{"Item":{"type":"object","properties":{"id":{"type":"string"},"externalId":{"type":["string","null"]},"kind":{"type":"string","enum":["LOST","FOUND"]},"status":{"type":"string","enum":["OPEN","MATCHED","CLAIMED","RETURNED","CLOSED","EXPIRED"]},"title":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string"},"color":{"type":["string","null"]},"brand":{"type":["string","null"]},"location":{"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"}]},"address":{"type":["string","null"]},"radiusMeters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"occurredAt":{"type":"string","description":"ISO 8601 timestamp"},"hiddenDetails":{"type":["string","null"]},"storageLocation":{"type":["string","null"]},"isPublic":{"type":"boolean"},"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"additionalProperties":false}},"publicUrl":{"type":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","externalId","kind","status","title","description","category","color","brand","location","address","radiusMeters","occurredAt","hiddenDetails","storageLocation","isPublic","photos","publicUrl","createdAt","updatedAt"],"additionalProperties":false},"ItemList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"externalId":{"type":["string","null"]},"kind":{"type":"string","enum":["LOST","FOUND"]},"status":{"type":"string","enum":["OPEN","MATCHED","CLAIMED","RETURNED","CLOSED","EXPIRED"]},"title":{"type":"string"},"description":{"type":["string","null"]},"category":{"type":"string"},"color":{"type":["string","null"]},"brand":{"type":["string","null"]},"location":{"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"}]},"address":{"type":["string","null"]},"radiusMeters":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"occurredAt":{"type":"string","description":"ISO 8601 timestamp"},"hiddenDetails":{"type":["string","null"]},"storageLocation":{"type":["string","null"]},"isPublic":{"type":"boolean"},"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"additionalProperties":false}},"publicUrl":{"type":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","externalId","kind","status","title","description","category","color","brand","location","address","radiusMeters","occurredAt","hiddenDetails","storageLocation","isPublic","photos","publicUrl","createdAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"],"additionalProperties":false},"ItemCreate":{"type":"object","properties":{"title":{"type":"string","minLength":3,"maxLength":120},"description":{"type":"string","maxLength":2000},"category":{"type":"string","enum":["phone","wallet","keys","bag","id","electronics","jewelry","clothing","eyewear","pet","toy","other"]},"color":{"type":"string","maxLength":40},"brand":{"type":"string","maxLength":60},"location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"description":"Where it was found. Defaults to the organization's center."},"address":{"type":"string","maxLength":300,"description":"Human-readable place, e.g. 'Food court, Level 2'"},"radiusMeters":{"type":"integer","minimum":10,"maximum":5000},"occurredAt":{"description":"When it was found/lost (ISO 8601). Defaults to now."},"hiddenDetails":{"type":"string","maxLength":500,"description":"Private detail used to verify claims. Never shown publicly."},"storageLocation":{"type":"string","maxLength":120,"description":"Where you keep it, e.g. 'Desk B, shelf 3'. Staff only."},"isPublic":{"type":"boolean","description":"Show on the public map and your public page."},"externalId":{"description":"Your system's id. Re-sending the same externalId returns the existing item (idempotent).","type":"string","minLength":1,"maxLength":100,"pattern":"^[\\w.:\\-/]+$"},"kind":{"description":"Defaults to FOUND.","type":"string","enum":["LOST","FOUND"]}},"required":["title","category"]},"ItemUpsert":{"type":"object","properties":{"title":{"type":"string","minLength":3,"maxLength":120},"description":{"type":"string","maxLength":2000},"category":{"type":"string","enum":["phone","wallet","keys","bag","id","electronics","jewelry","clothing","eyewear","pet","toy","other"]},"color":{"type":"string","maxLength":40},"brand":{"type":"string","maxLength":60},"location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"description":"Where it was found. Defaults to the organization's center."},"address":{"type":"string","maxLength":300,"description":"Human-readable place, e.g. 'Food court, Level 2'"},"radiusMeters":{"type":"integer","minimum":10,"maximum":5000},"occurredAt":{"description":"When it was found/lost (ISO 8601). Defaults to now."},"hiddenDetails":{"type":"string","maxLength":500,"description":"Private detail used to verify claims. Never shown publicly."},"storageLocation":{"type":"string","maxLength":120,"description":"Where you keep it, e.g. 'Desk B, shelf 3'. Staff only."},"isPublic":{"type":"boolean","description":"Show on the public map and your public page."},"kind":{"description":"Defaults to FOUND.","type":"string","enum":["LOST","FOUND"]}},"required":["title","category"]},"ItemUpdate":{"type":"object","properties":{"title":{"type":"string","minLength":3,"maxLength":120},"description":{"type":"string","maxLength":2000},"category":{"type":"string","enum":["phone","wallet","keys","bag","id","electronics","jewelry","clothing","eyewear","pet","toy","other"]},"color":{"type":"string","maxLength":40},"brand":{"type":"string","maxLength":60},"location":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}},"required":["lat","lng"],"description":"Where it was found. Defaults to the organization's center."},"address":{"type":"string","maxLength":300,"description":"Human-readable place, e.g. 'Food court, Level 2'"},"radiusMeters":{"type":"integer","minimum":10,"maximum":5000},"occurredAt":{"description":"When it was found/lost (ISO 8601). Defaults to now."},"hiddenDetails":{"type":"string","maxLength":500,"description":"Private detail used to verify claims. Never shown publicly."},"storageLocation":{"type":"string","maxLength":120,"description":"Where you keep it, e.g. 'Desk B, shelf 3'. Staff only."},"isPublic":{"type":"boolean","description":"Show on the public map and your public page."},"externalId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[\\w.:\\-/]+$"},{"type":"null"}]},"status":{"description":"RETURNED closes the case and notifies approved claimants.","type":"string","enum":["OPEN","RETURNED","CLOSED"]}}},"Photo":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}},"required":["id","url"],"additionalProperties":false},"PhotoFromUrl":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public https image URL (jpeg/png/webp/heic, max 8 MB)."}},"required":["url"]},"Claim":{"type":"object","properties":{"id":{"type":"string"},"itemId":{"type":"string"},"itemExternalId":{"type":["string","null"]},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED"]},"proof":{"type":"string","description":"Claimant's description of identifying details"},"claimant":{"type":"object","properties":{"name":{"type":["string","null"]}},"required":["name"],"additionalProperties":false},"reviewNote":{"type":["string","null"]},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"reviewedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp"},{"type":"null"}]}},"required":["id","itemId","itemExternalId","status","proof","claimant","reviewNote","createdAt","reviewedAt"],"additionalProperties":false},"ClaimList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"itemId":{"type":"string"},"itemExternalId":{"type":["string","null"]},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED"]},"proof":{"type":"string","description":"Claimant's description of identifying details"},"claimant":{"type":"object","properties":{"name":{"type":["string","null"]}},"required":["name"],"additionalProperties":false},"reviewNote":{"type":["string","null"]},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"reviewedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp"},{"type":"null"}]}},"required":["id","itemId","itemExternalId","status","proof","claimant","reviewNote","createdAt","reviewedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"],"additionalProperties":false},"Match":{"type":"object","properties":{"id":{"type":"string"},"score":{"type":"number","description":"0–1 match confidence"},"status":{"type":"string","enum":["SUGGESTED","CONFIRMED","REJECTED"]},"lostItem":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"status":{"type":"string"},"ownedByYou":{"type":"boolean"},"externalId":{"description":"Only set for your own items","type":["string","null"]}},"required":["id","title","category","status","ownedByYou","externalId"],"additionalProperties":false},"foundItem":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"status":{"type":"string"},"ownedByYou":{"type":"boolean"},"externalId":{"description":"Only set for your own items","type":["string","null"]}},"required":["id","title","category","status","ownedByYou","externalId"],"additionalProperties":false},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","score","status","lostItem","foundItem","createdAt"],"additionalProperties":false},"MatchList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"score":{"type":"number","description":"0–1 match confidence"},"status":{"type":"string","enum":["SUGGESTED","CONFIRMED","REJECTED"]},"lostItem":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"status":{"type":"string"},"ownedByYou":{"type":"boolean"},"externalId":{"description":"Only set for your own items","type":["string","null"]}},"required":["id","title","category","status","ownedByYou","externalId"],"additionalProperties":false},"foundItem":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"status":{"type":"string"},"ownedByYou":{"type":"boolean"},"externalId":{"description":"Only set for your own items","type":["string","null"]}},"required":["id","title","category","status","ownedByYou","externalId"],"additionalProperties":false},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","score","status","lostItem","foundItem","createdAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"],"additionalProperties":false},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"failureCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","url","events","active","failureCount","createdAt"],"additionalProperties":false},"WebhookEndpointWithSecret":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"failureCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"secret":{"type":"string","description":"Used to verify the X-WBIB-Signature header. Store it securely."}},"required":["id","url","events","active","failureCount","createdAt","secret"],"additionalProperties":false},"WebhookList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string"}},"active":{"type":"boolean"},"failureCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","url","events","active","failureCount","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false},"WebhookCreate":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"HTTPS endpoint that receives POSTed events."},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["item.created","item.updated","item.status_changed","item.deleted","match.created","claim.created","claim.reviewed"]},"description":"Events to subscribe to."}},"required":["url","events"]},"WebhookUpdate":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"HTTPS endpoint that receives POSTed events."},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["item.created","item.updated","item.status_changed","item.deleted","match.created","claim.created","claim.reviewed"]},"description":"Events to subscribe to."},"active":{"type":"boolean"}}},"WebhookEvent":{"type":"object","properties":{"id":{"type":"string","description":"Unique event id (use for de-duplication)"},"event":{"type":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","event","createdAt","data"],"additionalProperties":false},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable code, e.g. unauthorized, rate_limited, validation_error, not_found"},"message":{"type":"string"},"details":{}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}},"paths":{"/items":{"get":{"tags":["Items"],"summary":"List items","description":"Required scope: `items:read`","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"Pass `nextCursor` from the previous page.","schema":{"description":"Pass `nextCursor` from the previous page.","type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["OPEN","MATCHED","CLAIMED","RETURNED","CLOSED","EXPIRED"]}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["LOST","FOUND"]}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"ISO 8601 timestamp; only items updated after it.","schema":{"description":"ISO 8601 timestamp; only items updated after it."}}],"responses":{"200":{"description":"A page of items, newest first","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemList"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"post":{"tags":["Items"],"summary":"Create an item","description":"Returns `201` when created, or `200` with the existing item if `externalId` was already used.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemCreate"}}}},"responses":{"200":{"description":"Already exists (same externalId)","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"201":{"description":"Created","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/items/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Item id","schema":{"type":"string"}}],"get":{"tags":["Items"],"summary":"Get an item","description":"Required scope: `items:read`","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"The item","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"patch":{"tags":["Items"],"summary":"Update an item","description":"Only sent fields change. Setting `status` to `RETURNED` notifies approved claimants and closes linked lost reports.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemUpdate"}}}},"responses":{"200":{"description":"Updated item","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"externalId already used","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"delete":{"tags":["Items"],"summary":"Delete an item","description":"Required scope: `items:write`","security":[{"bearerAuth":[]}],"responses":{"204":{"description":"Deleted","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/items/by-external/{externalId}":{"parameters":[{"name":"externalId","in":"path","required":true,"description":"Your id for the item (URL-encoded)","schema":{"type":"string"}}],"get":{"tags":["Items"],"summary":"Get an item by externalId","description":"Required scope: `items:read`","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"The item","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"put":{"tags":["Items"],"summary":"Upsert an item by externalId","description":"Creates the item if it doesn't exist (201), otherwise updates it (200). `kind` is ignored on update.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemUpsert"}}}},"responses":{"200":{"description":"Updated","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"201":{"description":"Created","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Item"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/items/{id}/photos":{"parameters":[{"name":"id","in":"path","required":true,"description":"Item id","schema":{"type":"string"}}],"post":{"tags":["Photos"],"summary":"Add a photo","description":"Upload the image as `multipart/form-data` (field `file`), or send JSON `{ \"url\": \"https://…\" }` and we'll download it. JPEG/PNG/WebP/HEIC, max 8 MB, max 6 photos per item.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}},"application/json":{"schema":{"$ref":"#/components/schemas/PhotoFromUrl"}}}},"responses":{"201":{"description":"Photo added","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Photo"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Item not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Photo limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported image type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Invalid request or download failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/items/{id}/photos/{photoId}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Item id","schema":{"type":"string"}},{"name":"photoId","in":"path","required":true,"description":"Photo id","schema":{"type":"string"}}],"delete":{"tags":["Photos"],"summary":"Delete a photo","description":"Required scope: `items:write`","security":[{"bearerAuth":[]}],"responses":{"204":{"description":"Deleted","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/claims":{"get":{"tags":["Claims"],"summary":"List claims on your items","description":"Required scope: `claims:read`","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED"]}},{"name":"itemId","in":"query","required":false,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{}}],"responses":{"200":{"description":"A page of claims, newest first","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimList"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/matches":{"get":{"tags":["Matches"],"summary":"List matches involving your items","description":"Required scope: `matches:read`","security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["SUGGESTED","CONFIRMED","REJECTED"]}},{"name":"itemId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A page of matches, newest first","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchList"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/webhooks":{"get":{"tags":["Webhooks"],"summary":"List webhook endpoints","description":"Required scope: `webhooks:manage`","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Endpoints","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookList"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"post":{"tags":["Webhooks"],"summary":"Create a webhook endpoint","description":"The response includes the signing `secret` — store it; it's also visible to org admins in the dashboard.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"}}}},"responses":{"201":{"description":"Created","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Endpoint limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/webhooks/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id","schema":{"type":"string"}}],"get":{"tags":["Webhooks"],"summary":"Get a webhook endpoint","description":"Required scope: `webhooks:manage`","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Endpoint","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"patch":{"tags":["Webhooks"],"summary":"Update a webhook endpoint","description":"Set `active: true` to re-enable an endpoint that was auto-disabled after repeated failures.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUpdate"}}}},"responses":{"200":{"description":"Updated","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}},"delete":{"tags":["Webhooks"],"summary":"Delete a webhook endpoint","description":"Required scope: `webhooks:manage`","security":[{"bearerAuth":[]}],"responses":{"204":{"description":"Deleted","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}},"/webhooks/{id}/test":{"parameters":[{"name":"id","in":"path","required":true,"description":"Endpoint id","schema":{"type":"string"}}],"post":{"tags":["Webhooks"],"summary":"Send a test 'ping' event","description":"Required scope: `webhooks:manage`","security":[{"bearerAuth":[]}],"responses":{"202":{"description":"Queued","headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"401":{"description":"Missing, invalid, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the required scope, or API access is disabled for the organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit or daily quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed in the current window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}}}}}}},"webhooks":{"item.created":{"post":{"summary":"Item created","description":"Sent when: item created. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"item.updated":{"post":{"summary":"Item updated","description":"Sent when: item updated. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"item.status_changed":{"post":{"summary":"Item status changed","description":"Sent when: item status changed. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"item.deleted":{"post":{"summary":"Item deleted","description":"Sent when: item deleted. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"match.created":{"post":{"summary":"Possible match found","description":"Sent when: possible match found. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"claim.created":{"post":{"summary":"Claim submitted","description":"Sent when: claim submitted. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}},"claim.reviewed":{"post":{"summary":"Claim approved / rejected","description":"Sent when: claim approved / rejected. Headers: `X-WBIB-Event`, `X-WBIB-Delivery`, `X-WBIB-Signature`. Respond with any 2xx within 10 seconds.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEvent"}}}},"responses":{"200":{"description":"Acknowledged"}}}}}}