{"openapi":"3.1.0","info":{"title":"Liuma Chief Talent Officer Consultation","description":"Manually fulfilled Chief Talent Officer consultation for a digital-team plan.\n\nBuyers submit a brief. They do not set the fee and they do not set a paid flag.\nThe server fee defaults to 1.00 USD unless PRICE_AMOUNT_MINOR and PRICE_CURRENCY\noverride it. A missing PayPal configuration returns payment_not_configured and\ndoes not charge.\n\nA person must approve the payment on PayPal. An agent cannot pay by itself.\nThe order is paid only after a COMPLETED capture for the exact quote.\nPENDING is not paid. Paid is not a bank deposit and is not a PayPal withdrawal.\nThe plan is due 12 hours after paid_at. Refund terms are a TODO for the owner.\nSandbox PayPal is refused in production. There is no endpoint that marks an order paid.\n\nServing this document does not register the service in an agent directory and\ndoes not by itself send any traffic.","version":"0.1.0"},"servers":[{"url":"https://talent.liumateam.com"}],"paths":{"/health":{"get":{"tags":["service"],"summary":"Process health","description":"Reports quote mode and whether a live merchant is configured. It does not reveal secrets.","operationId":"get_health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/service":{"get":{"tags":["service"],"summary":"Service description","description":"Discovery JSON for a caller that already has this base URL. Serving it does not register the service anywhere.","operationId":"get_service_api_v1_service_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/orders":{"post":{"tags":["orders"],"summary":"Create an order","description":"Records a brief. Requires Idempotency-Key. Does not charge. The server quotes its configured fee (1.00 USD unless overridden). The customer token is returned here and must be sent later as a bearer token.","operationId":"post_order_api_v1_orders_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/orders/{order_id}":{"get":{"tags":["orders"],"summary":"Order status","description":"Requires the customer bearer token. A wrong token looks the same as an unknown order. Does not charge.","operationId":"get_order_api_v1_orders__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/orders/{order_id}/result":{"get":{"tags":["orders"],"summary":"Delivered plan","description":"Released only when payment_status is paid, refund_status is none, and fulfillment_status is delivered. Does not charge.","operationId":"get_result_api_v1_orders__order_id__result_get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/orders/{order_id}/checkout":{"post":{"tags":["payments"],"summary":"Start hosted checkout","description":"Returns a provider URL only when a live merchant is configured and a server quote exists. Does not mark the order paid. Repeating the call reuses the existing session.","operationId":"post_checkout_api_v1_orders__order_id__checkout_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/orders/{order_id}/capture":{"post":{"tags":["payments"],"summary":"Capture an approved PayPal order","description":"A human must already have approved the PayPal order. This call asks PayPal to capture it and marks the order paid only when the retrieved capture is COMPLETED for the exact server quote. PENDING is not paid. An agent cannot approve the payment itself.","operationId":"post_capture_api_v1_orders__order_id__capture_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/payments/webhooks/paypal":{"post":{"tags":["payments"],"summary":"PayPal webhook","description":"Asks PayPal to verify the webhook signature, then retrieves the capture and checks the order reference, amount, currency, and COMPLETED status. PENDING is not paid. Sandbox is rejected. Duplicates do not apply twice. An unconfigured provider returns payment_not_configured and changes nothing.","operationId":"post_webhook_api_v1_payments_webhooks_paypal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/admin/orders":{"get":{"tags":["admin"],"summary":"List orders","operationId":"get_admin_orders_api_v1_admin_orders_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}":{"get":{"tags":["admin"],"summary":"Read one order","operationId":"get_admin_order_api_v1_admin_orders__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/quote":{"post":{"tags":["admin"],"summary":"Set a per-order quote","description":"Used only when no server price is configured. The buyer cannot call this.","operationId":"post_quote_api_v1_admin_orders__order_id__quote_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/manual-payment":{"post":{"tags":["admin"],"summary":"Record a manual payment attestation","description":"Staff only. Matches the server quote, stores evidence and the operator, and is not provider verification. Test or demo evidence is rejected. Bank deposit stays unconfirmed.","operationId":"post_manual_api_v1_admin_orders__order_id__manual_payment_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/fulfillment/start":{"post":{"tags":["admin"],"summary":"Mark fulfillment started","operationId":"post_start_api_v1_admin_orders__order_id__fulfillment_start_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/fulfillment":{"post":{"tags":["admin"],"summary":"Deliver the plan","description":"Allowed only after payment_status is paid and no refund is recorded. Accepts a structured plan or markdown of at least 200 characters.","operationId":"post_fulfillment_api_v1_admin_orders__order_id__fulfillment_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/refunds":{"post":{"tags":["admin"],"summary":"Record a refund note","description":"Does not move money and does not promise a refund. Records an operator attestation or, via the webhook, a verified provider refund event.","operationId":"post_refund_api_v1_admin_orders__order_id__refunds_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/attachments":{"post":{"tags":["admin"],"summary":"Upload an attachment","operationId":"post_attachment_api_v1_admin_orders__order_id__attachments_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/orders/{order_id}/attachments/{attachment_id}":{"get":{"tags":["orders"],"summary":"Download a delivered attachment","operationId":"get_customer_attachment_api_v1_orders__order_id__attachments__attachment_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string","title":"Attachment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/api/v1/admin/orders/{order_id}/attachments/{attachment_id}":{"get":{"tags":["admin"],"summary":"Download an attachment as staff","operationId":"get_admin_attachment_api_v1_admin_orders__order_id__attachments__attachment_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string","title":"Attachment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Rejected request"},"401":{"description":"Admin authentication required"},"403":{"description":"Authenticated but not allowed"},"404":{"description":"No matching order"},"409":{"description":"State conflict"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}}}}