{"openapi":"3.0.3","info":{"title":"Meridian Workspace API","version":"3.1.0","description":"Purchasing, vehicle operations, documents, collaboration and local partner workflows."},"servers":[{"url":"https://qwen.carmax.pw"}],"paths":{"/api/auth/login":{"post":{"summary":"Sign in","operationId":"sign_in","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"alice@meridian.local","password":"your-test-password"}}}}}},"/api/auth/session":{"get":{"summary":"Start a browser session","operationId":"start_a_browser_session","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/auth/refresh":{"post":{"summary":"Refresh access","operationId":"refresh_access","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"refreshToken":"token"}}}}}},"/api/auth/logout":{"post":{"summary":"Sign out","operationId":"sign_out","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/auth/forgot":{"post":{"summary":"Request account recovery","operationId":"request_account_recovery","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"user@meridian.local"}}}}}},"/api/auth/recovery-preview":{"get":{"summary":"Preview current test identity recovery mailbox","operationId":"preview_current_test_identity_recovery_mailbox","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/auth/reset":{"post":{"summary":"Recover account","operationId":"recover_account","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"user@meridian.local","token":"recovery-token","password":"new-password"}}}}}},"/api/me":{"get":{"summary":"Current identity","operationId":"current_identity","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/mtls/me":{"get":{"summary":"Certificate identity","operationId":"certificate_identity","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/workspace/cases":{"get":{"summary":"List service cases","operationId":"list_service_cases","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["updated","title","status"],"default":"updated"}},{"name":"direction","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}]}},"/api/workspace/cases/{id}":{"get":{"summary":"Service case details","operationId":"service_case_details","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/workspace/cases/{id}/notes":{"get":{"summary":"Service case notes","operationId":"service_case_notes","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/workspace/requests":{"get":{"summary":"List workspace requests","operationId":"list_workspace_requests","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/workspace/requests/{id}/cancel":{"post":{"summary":"Cancel workspace request","operationId":"cancel_workspace_request","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"reason":"Request no longer needed"}}}}}},"/api/projects":{"get":{"summary":"List workspace projects","operationId":"list_workspace_projects","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/invoices":{"get":{"summary":"List invoices","operationId":"list_invoices","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","default":"amount DESC"}}]}},"/api/invoices/{id}":{"get":{"summary":"Invoice details","operationId":"invoice_details","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/invoices/{id}/approve":{"post":{"summary":"Approve invoice","operationId":"approve_invoice","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{}}}}}},"/api/projects/{id}/comments":{"get":{"summary":"Project discussion","operationId":"project_discussion","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Post discussion","operationId":"post_discussion","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"body":"Please confirm delivery."}}}}}},"/api/profile":{"post":{"summary":"Update profile","operationId":"update_profile","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Your name"}}}}}},"/api/admin/vendors":{"post":{"summary":"Create vendor (administrator operation)","operationId":"create_vendor_administrator_operation_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Partner name","bank_account":"TEST-ACCOUNT"}}}}}},"/api/directory/search":{"post":{"summary":"Search staff directory","operationId":"search_staff_directory","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"filter":{"email":"alice@meridian.local"}}}}}}},"/api/diagnostics/resolve":{"post":{"summary":"Resolve integration hostname","operationId":"resolve_integration_hostname","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"hostname":"localhost"}}}}}},"/api/integrations/config":{"get":{"summary":"Partner integration settings","operationId":"partner_integration_settings","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/integrations/preview":{"post":{"summary":"Preview partner resource","operationId":"preview_partner_resource","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"url":"http://localhost:34757/partner/status"}}}}}},"/api/integrations/catalog":{"post":{"summary":"Import partner quote","operationId":"import_partner_quote","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"url":"http://localhost:34757/partner/pricing"}}}}}},"/api/reports":{"post":{"summary":"Create invoice export","operationId":"create_invoice_export","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{}}}}}},"/api/reports/{id}":{"get":{"summary":"Export status","operationId":"export_status","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/reports/{id}/download":{"get":{"summary":"Download export","operationId":"download_export","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/reports/preview":{"post":{"summary":"Preview report layout","operationId":"preview_report_layout","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"template":"Hello {{ user.name }}"}}}}}},"/api/preferences/import":{"post":{"summary":"Import nested preferences","operationId":"import_nested_preferences","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"paths":["appearance.theme"],"values":["light"]}}}}}},"/api/preferences/policy":{"get":{"summary":"Current export policy","operationId":"current_export_policy","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/imports/session":{"post":{"summary":"Import session","operationId":"import_session","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"blob":"eyJuYW1lIjoiQWxpY2UifQ=="}}}}}},"/api/catalog":{"get":{"summary":"Browse supplies","operationId":"browse_supplies","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/orders":{"get":{"summary":"Order history","operationId":"order_history","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}},"post":{"summary":"Create purchase request","operationId":"create_purchase_request","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"productId":"workspace-kit","quantity":1}}}}}},"/api/orders/{id}/checkout":{"post":{"summary":"Request checkout","operationId":"request_checkout","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"coupon":"WELCOME20"}}}}}},"/api/orders/{id}/fulfill":{"post":{"summary":"Dispatch paid order","operationId":"dispatch_paid_order","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{}}}}}},"/api/payments/confirm":{"post":{"summary":"Process payment confirmation","operationId":"process_payment_confirmation","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"orderId":"order-id","providerResponse":"{\"approved\":true}"}}}}}},"/api/exports/bulk":{"post":{"summary":"Create copies of workspace export","operationId":"create_copies_of_workspace_export","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"copies":1}}}}}},"/api/audit/export":{"get":{"summary":"Export audit records (administrator operation)","operationId":"export_audit_records_administrator_operation_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/events":{"get":{"summary":"Subscribe to project event stream","operationId":"subscribe_to_project_event_stream","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"projectId","in":"query","required":true,"schema":{"type":"string"}},{"name":"Last-Event-ID","in":"header","schema":{"type":"integer"}}]}},"/api/text/format":{"post":{"summary":"Format display text","operationId":"format_display_text","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"text":"workspace"}}}}}},"/api/auth/token-exchange":{"post":{"summary":"Exchange mobile access token","operationId":"exchange_mobile_access_token","security":[],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"client":"workspace-mobile","token":"access-token"}}}}}},"/api/v2/invoices":{"get":{"summary":"List invoices (v2)","operationId":"list_invoices_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","default":"amount"}}]}},"/api/v2/invoices/{id}":{"get":{"summary":"Invoice details (v2)","operationId":"invoice_details_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/api/v2/search":{"get":{"summary":"Search workspace (v2)","operationId":"search_workspace_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}}]}},"/api/v2/profile":{"post":{"summary":"Update profile (v2)","operationId":"update_profile_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Your name"}}}}}},"/api/v2/admin/vendors":{"post":{"summary":"Create vendor (v2)","operationId":"create_vendor_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Partner name","bank_account":"TEST-ACCOUNT"}}}}}},"/api/v2/directory/search":{"post":{"summary":"Search staff directory (v2)","operationId":"search_staff_directory_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"alice@meridian.local"}}}}}},"/api/v2/diagnostics/resolve":{"post":{"summary":"Resolve integration hostname (v2)","operationId":"resolve_integration_hostname_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"hostname":"localhost"}}}}}},"/api/v2/integrations/preview":{"post":{"summary":"Preview partner resource (v2)","operationId":"preview_partner_resource_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"url":"http://localhost:34757/partner/status"}}}}}},"/api/v2/reports/preview":{"post":{"summary":"Preview report layout (v2)","operationId":"preview_report_layout_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"template":"Monthly procurement summary"}}}}}},"/api/v2/imports/session":{"post":{"summary":"Import session (v2)","operationId":"import_session_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"blob":"eyJuYW1lIjoiQWxpY2UifQ=="}}}}}},"/api/v2/preferences/import":{"post":{"summary":"Import nested preferences (v2)","operationId":"import_nested_preferences_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"paths":["appearance.theme"],"values":["light"]}}}}}},"/api/v2/payments/confirm":{"post":{"summary":"Process payment confirmation (v2)","operationId":"process_payment_confirmation_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"orderId":"order-id","providerResponse":"{\"approved\":true}"}}}}}},"/api/v2/events":{"get":{"summary":"Subscribe to project event stream (v2)","operationId":"subscribe_to_project_event_stream_v2_","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"parameters":[{"name":"projectId","in":"query","required":true,"schema":{"type":"string"}},{"name":"Last-Event-ID","in":"header","schema":{"type":"integer"}}]}},"/api/assistant/config":{"get":{"summary":"Assistant configuration","operationId":"assistant_configuration","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}}}},"/api/assistant/documents":{"post":{"summary":"Import partner knowledge","operationId":"import_partner_knowledge","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"projectId":"project-id","title":"Partner notes","body":"Delivery lead time: two weeks."}}}}}},"/api/assistant/chat":{"post":{"summary":"Discuss project with assistant","operationId":"discuss_project_with_assistant","security":[{"bearerAuth":[]},{"apiKey":[]},{"sessionCookie":[]}],"responses":{"200":{"description":"Operation result"},"401":{"description":"Authentication required"},"403":{"description":"Insufficient permission"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"projectId":"project-id","message":"Summarize procurement notes."}}}}}},"/api/workspace/preferences":{"get":{"summary":"Notification and currency preferences","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Save notification preferences","parameters":[{"name":"X-CSRF-Token","in":"header","description":"Current workspace session request token","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"notificationEmail":{"type":"string"},"currency":{"type":"string"}}},"example":{"notificationEmail":"alice@meridian.local","currency":"USD"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/workspace/preferences/update":{"get":{"summary":"Legacy notification preference link","parameters":[{"name":"notificationEmail","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/browser/connector":{"get":{"summary":"Embedded workspace notification settings","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/browser/connector.js":{"get":{"summary":"Workspace connector client","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/.well-known/openid-configuration":{"get":{"summary":"Local identity discovery","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/jwks":{"get":{"summary":"Local identity public keys","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/{issuer}/authorize":{"get":{"summary":"Authorize workspace application","parameters":[{"name":"issuer","in":"path","required":true,"schema":{"type":"string"}},{"name":"client_id","in":"query","schema":{"type":"string"}},{"name":"redirect_uri","in":"query","schema":{"type":"string"}},{"name":"response_type","in":"query","schema":{"type":"string"}},{"name":"code_challenge_method","in":"query","schema":{"type":"string"}},{"name":"code_challenge","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"scope","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/token":{"post":{"summary":"Exchange an application authorization code","parameters":[],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"client_id":{"type":"string"},"redirect_uri":{"type":"string"},"code_verifier":{"type":"string"}}},"example":{"code":"Authorization code from the registered callback","client_id":"workspace-browser","redirect_uri":"https://qwen.carmax.pw/identity/callback","code_verifier":"The application transaction verifier"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/identity/resources/{audience}":{"get":{"summary":"Read an application resource","parameters":[{"name":"audience","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/identity/dispatch":{"post":{"summary":"Record an authorized transport dispatch","parameters":[],"security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/callback":{"get":{"summary":"Application authorization return","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/identity/report-callback":{"get":{"summary":"Application authorization return","parameters":[],"security":[],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/files":{"get":{"summary":"List workspace attachment metadata","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Upload a small UTF-8 fixture attachment","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string"},"contentType":{"type":"string"},"content":{"type":"string"}}},"example":{"filename":"delivery-plan.txt","contentType":"text/plain","content":"Delivery window confirmed for Friday."}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/files/{id}":{"put":{"summary":"Replace an attachment version","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string"},"content":{"type":"string"}}},"example":{"contentType":"text/plain","content":"Delivery window confirmed for Monday."}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/files/{id}/review":{"post":{"summary":"Record an attachment review for its current version","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/files/{id}/download":{"get":{"summary":"Download a reviewed workspace attachment","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/files/{id}/preview":{"get":{"summary":"Preview a reviewed attachment in an inert sandbox","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/file-storage":{"get":{"summary":"Resolve a path inside the synthetic attachment store","parameters":[{"name":"path","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/account-links/challenges":{"post":{"summary":"Begin linking a fictional fleet-provider identity","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/account-links":{"post":{"summary":"Complete a fictional fleet-provider account link","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"challengeId":{"type":"string"},"token":{"type":"string"},"subject":{"type":"string"},"email":{"type":"string"}}},"example":{"challengeId":"Account-link challenge ID","token":"Current account-link challenge token","subject":"fleet-alice","email":"alice@meridian.local"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"get":{"summary":"List linked provider accounts","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/partner-workspace":{"get":{"summary":"Read acquisition notes from the linked fictional provider","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/workspace-summary":{"get":{"summary":"Read a cached workspace procurement summary","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/workspace-summary/refresh":{"post":{"summary":"Invalidate cached summaries for an authorized workspace","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/export-jobs":{"post":{"summary":"Queue a workspace transport export","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}},"example":{}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/export-jobs/{id}":{"get":{"summary":"Read the status of an export requested by this identity","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/export-jobs/{id}/download":{"get":{"summary":"Download a completed workspace export","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/imports":{"post":{"summary":"Import bounded transport records for background report and index processing","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"},"vendor":{"type":"string"},"amountCents":{"type":"integer"},"note":{"type":"string"}}}},"reportTemplate":{"type":"string"}}},"example":{"rows":[{"sourceId":"TRANSPORT-DEMO-001","vendor":"Northstar Fleet","amountCents":12500,"note":"Delivery schedule confirmed."}],"reportTemplate":"{{ record.vendor }}: {{ record.amountCents }}"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/imports/{id}":{"get":{"summary":"Read workspace import processing status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/imports/{id}/report":{"get":{"summary":"Download a processed data-only transport report","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/search-index":{"get":{"summary":"Search transport records produced by background indexing","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/invitations/received":{"get":{"summary":"List invitations addressed to the current identity","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/invitations":{"post":{"summary":"Invite an identity into the current workspace","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"recipientEmail":{"type":"string"},"role":{"type":"string"}}},"example":{"recipientEmail":"cara@meridian.local","role":"viewer"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/invitations/{id}":{"get":{"summary":"Read an invitation landing-page summary","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/invitations/{id}/accept":{"post":{"summary":"Accept a current workspace invitation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"tenant_id":{"type":"string"}}},"example":{"token":"Invitation acceptance token","tenant_id":"atlas"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/memberships":{"get":{"summary":"List this identity’s workspace memberships","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/memberships/{id}/revoke":{"post":{"summary":"Remove a workspace membership","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/memberships/{id}":{"patch":{"summary":"Change a workspace membership role","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string"}}},"example":{"role":"viewer"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/collaboration/messages":{"get":{"summary":"Read current workspace collaboration messages","parameters":[{"name":"tenant_id","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Post a transport collaboration update","parameters":[{"name":"tenant_id","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tenant_id":{"type":"string"},"message":{"type":"string"}}},"example":{"tenant_id":"atlas","message":"Carrier pickup confirmed."}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/collaboration/events":{"get":{"summary":"Subscribe to workspace collaboration events over SSE","parameters":[{"name":"tenant_id","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/document-events":{"get":{"summary":"Read acquisition document notification metadata","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/document-capabilities":{"post":{"summary":"Issue a short-lived acquisition document review capability","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"string"},"reviewReference":{"type":"string"}}},"example":{"documentId":"Acquisition document ID","reviewReference":"Document event review reference"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/documents/download":{"get":{"summary":"Redeem a signed acquisition document review capability","parameters":[{"name":"capability","in":"query","schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/overview":{"get":{"summary":"Purchasing, reservations, deposits and mock payment workflows","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/invoices":{"get":{"summary":"List workspace reconditioning invoices","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Submit a reconditioning invoice","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"},"beneficiary":{"type":"string"},"amount":{"type":"number"},"currency":{"type":"string"},"purpose":{"type":"string"}}},"example":{"vendor":"Northstar Reconditioning","beneficiary":"ATLAS-DEMO-OPERATING","amount":225.5,"currency":"USD","purpose":"Reconditioning work"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/invoices/{id}":{"get":{"summary":"Read a workspace invoice and its approval","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"patch":{"summary":"Update invoice amount, payment destination and attachments","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer"},"currency":{"type":"string"},"beneficiary":{"type":"string"},"attachment_ids":{"type":"array","items":{"type":"string"}}}},"example":{"amount":230,"currency":"USD","beneficiary":"ATLAS-DEMO-OPERATING","attachment_ids":[]}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/invoices/{id}/recall":{"post":{"summary":"Recall approval before revising an invoice","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/delegations":{"get":{"summary":"List workspace purchasing delegations","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Delegate invoice approval duties within the workspace","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"delegate_id":{"type":"string"}}},"example":{"delegate_id":"Workspace user ID"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/delegations/{id}":{"delete":{"summary":"Revoke a purchasing delegation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/invoices/{id}/approve":{"post":{"summary":"Approve a submitted reconditioning invoice","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/invoices/{id}/settle":{"post":{"summary":"Settle an approved invoice in the local payment ledger","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/commitments":{"get":{"summary":"List acquisition and transport commitments","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Record an acquisition or transport commitment","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"vendor":{"type":"string"},"reference":{"type":"string"},"amount":{"type":"number"},"currency":{"type":"string"}}},"example":{"vendor":"Northstar Fleet Demo","reference":"Acquisition batch DEMO-12","amount":125.25,"currency":"USD"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/deposits":{"get":{"summary":"List settled fictional vehicle deposits","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/deposits/{id}/refunds":{"get":{"summary":"List local deposit refunds","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":100}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Issue a partial refund in the local ledger","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":100}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer"},"currency":{"type":"string"}}},"example":{"amount":25,"currency":"USD"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/vehicles":{"get":{"summary":"List fictional vehicle inventory","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/reservations":{"get":{"summary":"List workspace vehicle reservations","parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":100}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/vehicles/{id}/reservations":{"post":{"summary":"Reserve a fictional inventory vehicle","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","schema":{"type":"string","maxLength":100}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customer_reference":{"type":"string"}}},"example":{"customer_reference":"Fictional buyer DEMO-42"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/reservations/{id}/cancel":{"post":{"summary":"Cancel an owned vehicle reservation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/orders":{"get":{"summary":"List local transport and acquisition payment orders","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"post":{"summary":"Create a synthetic transport dispatch order","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string"},"amount":{"type":"integer"},"currency":{"type":"string"}}},"example":{"reference":"Routine vehicle transport","amount":350,"currency":"USD"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/orders/{id}":{"get":{"summary":"Read a local transport payment order","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}},"patch":{"summary":"Revise an unfulfilled dispatch and request a fresh payment","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer"},"currency":{"type":"string"}}},"example":{"amount":375,"currency":"USD"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/orders/{id}/provider-events":{"get":{"summary":"List provider events for an owned dispatch order","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/orders/{id}/simulate-payment":{"post":{"summary":"Ask the local payment simulator to produce a bound payment event","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"type":"string"}}},"example":{"outcome":"settled"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/provider-events/{id}/deliver":{"post":{"summary":"Deliver an existing signed local provider event","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/webhooks/payment":{"post":{"summary":"Receive a signed local provider notification","parameters":[{"name":"X-Meridian-Provider-Signature","in":"header","required":true,"schema":{"type":"string"}}],"security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string"}}},"example":{"event":"Exact signed JSON from the configured local provider"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/commerce/orders/{id}/dispatch":{"post":{"summary":"Release a paid fictional transport dispatch","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}},"/api/workspace":{"get":{"summary":"Workspace home","parameters":[],"security":[{"session":[]},{"apiKey":[]},{"bearer":[]}],"responses":{"200":{"description":"Operation result"},"201":{"description":"Record created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Operation not permitted"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"},"sessionCookie":{"type":"apiKey","in":"cookie","name":"sid"},"session":{"type":"apiKey","in":"cookie","name":"sid"},"bearer":{"type":"http","scheme":"bearer"}}}}