{"openapi":"3.1.0","info":{"title":"POST /api/v1/bills/payment-suggestions/trigger","version":"1.0.0","description":"Trigger bill payment matching"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/bills/payment-suggestions/trigger":{"post":{"tags":["bills"],"summary":"Trigger bill payment matching","description":"Run the AP matching engine to find bank transactions that match open bills.","operationId":"trigger_bill_payment_matching_api_v1_bills_payment_suggestions_trigger_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerBillMatchingRequest","default":{"auto_match":false}}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerBillMatchingResponse"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"TriggerBillMatchingRequest":{"properties":{"min_confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Min Confidence","description":"Minimum confidence threshold (0.0–1.0)"},"auto_match":{"type":"boolean","title":"Auto Match","description":"If true, automatically accept high-confidence matches (>= 0.85)","default":false},"bill_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bill Ids","description":"Limit matching to specific bill UUIDs"}},"type":"object","title":"TriggerBillMatchingRequest","description":"Request schema for triggering bill payment matching."},"TriggerBillMatchingResponse":{"properties":{"suggestions_created":{"type":"integer","title":"Suggestions Created","description":"New suggestions created","default":0},"auto_linked":{"type":"integer","title":"Auto Linked","description":"Auto-accepted high-confidence matches","default":0},"total_candidates":{"type":"integer","title":"Total Candidates","description":"Total candidates evaluated","default":0}},"type":"object","title":"TriggerBillMatchingResponse","description":"Response schema for bill payment matching results."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}