Manage Line Request
Lines & Leads
Manage Line Request
Cancel a pending request or recover its payment link. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON request/response, full schema and.
POST
Manage Line Request
This endpoint supports small request-management actions. It does not create a new line request.
When To Use This Endpoint
Use this endpoint when the request already exists and the user asks one of these questions:- “I lost the payment link. Can I get it again?”
- “I changed my mind. Can I cancel this unpaid request?”
Authentication
Pass your workspace API key as a Bearer token, or use a Clerk session token.Path parameter
Required. The line request id returned by
POST /api/line-requests.Supported actions
Both actions only apply to pending-payment requests.
If the request is already in
provisioning, active, failed, or canceled, these actions no longer apply.
Recover payment link
Success (200 OK)
payment_link can act like a safe recovery action:
- if payment is still needed, it gives you the invoice again
- if payment has already been reconciled, it can return the updated provisioning state instead