Update a link | Mitu API Documentation

curl -X PATCH https://api.mitu.ai/v1/payment-links/id \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "description": "Two large pizzas and a side",
  "reference": "ORDER-8841",
  "expires_at": "2026-09-30T23:59:59.000Z"
}'

{
  "message": "Payment link retrieved successfully",
  "data": {
    "id": "pay_n8d7piu1yc6h",
    "type": "charge",
    "status": "pending",
    "amount": "25.00",
    "amount_paid": "0.00",
    "currency": "USD",
    "description": "Two large pizzas",
    "reference": "ORDER-8841",
    "url": {
      "checkout": "https://mitu.ai/pay/pay_n8d7piu1yc6h",
      "agent": "https://api.mitu.ai/pay/pay_n8d7piu1yc6h"
    },
    "payment_methods": [
      "x402",
      "mpp_crypto"
    ],
    "viewed_at": "2026-09-11T15:02:11.004Z",
    "expires_at": "2026-09-30T23:59:59.000Z",
    "paid_at": null,
    "created_at": "2026-09-11T15:00:34.915Z"
  }
}

Update a payment link.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Path parameters

idstringRequired

Unique identifier of the resource.

Request

This endpoint expects an object.

descriptionstringOptional<=2000 characters

referencestringOptional<=255 characters

expires_atdatetimeOptional

metadatamap from strings to stringsOptional

Response

Payment link updated successfully.

messagestring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error