Skip to main content
POST
/
api
/
line-requests
/
:id
Manage Line Request
curl --request POST \
  --url https://app.tuco.ai/api/line-requests/:id \
  --header 'Authorization: Bearer <token>'
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?”
This endpoint is only for requests that are still pending payment.

​
Authentication

Pass your workspace API key as a Bearer token, or use a Clerk session token. 
Authorization: Bearer tuco_xxxxxxxxxxxxx

​
Path parameter

​
id
string
Required. The line request id returned by POST /api/line-requests.

​
Supported actions

ActionWhat it does
payment_linkReturns the hosted invoice link again for an awaiting_payment request
cancelCancels an awaiting_payment request so it no longer blocks a new purchase
Both actions only apply to pending-payment requests. If the request is already in provisioning, active, failed, or canceled, these actions no longer apply. 
curl -X POST "https://app.tuco.ai/api/line-requests/6a092ebde4a7fbddc8a832da" \
  -H "Authorization: Bearer tuco_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "payment_link" }'

​
Success (200 OK)

{
  "success": true,
  "status": "awaiting_payment",
  "paymentUrl": "https://invoice.stripe.com/...",
  "invoiceId": "in_123",
  "reused": true
}
If the workspace entitlement has already updated, the same action can promote the line and return a normal provisioning response instead. That means 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

​
Cancel pending request

curl -X POST "https://app.tuco.ai/api/line-requests/6a092ebde4a7fbddc8a832da" \
  -H "Authorization: Bearer tuco_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "cancel" }'

​
Success (200 OK)

{
  "success": true,
  "status": "canceled",
  "line": {
    "_id": "6a092ebde4a7fbddc8a832da",
    "provisioningStatus": "canceled",
    "paymentStatus": "failed"
  }
}
After canceling, the workspace can create a different line request without waiting on the old unpaid one.

​
Error responses

StatusWhenBody
400Invalid line request id or unsupported action{ "error": "Invalid line request id" } or { "error": "Unsupported action" }
401Missing or invalid API key / session{ "error": "Unauthorized" }
403payment_link used without an active subscription{ "success": false, "status": "subscription_required", "message": "...", "redirect": "/billing" }
404Request not found in your workspace{ "error": "Line request not found" }
409Action does not apply to the current request state{ "success": false, "status": "...", "message": "..." }