Skip to Content
DevelopersAPI referenceRecurring invoices

Update recurring invoice

PATCH
/v1/recurring-invoices/{id}

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (blk_…) from Settings → API keys.

Path Parameters

id*string

Request Body

application/json
  1. body
title?|
Lengthlength <= 200
currency?string
Match^[A-Z]{3}$
Length3 <= length <= 3
lines?array<>
Items1 <= items <= 200
every?integer
Range1 <= value <= 12
unit?string
Value in"week""month""year"
endDate?|
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
maxOccurrences?|
Range1 <= value <= 1000
dueDays?|
Range0 <= value <= 365
mode?string
Value in"draft""send"
notes?|
Lengthlength <= 5000
terms?|
Lengthlength <= 5000
status?string
Value in"active""paused"

Response Body

application/json
  1. response
id*string
clientId*string
clientName*string
title*string|null
currency*string
lines*array<>
total*integer
Range-9007199254740991 <= value <= 9007199254740991
every*integer
Range-9007199254740991 <= value <= 9007199254740991
unit*string
Value in"week""month""year"
startDate*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
endDate*|
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
maxOccurrences*|
Range-9007199254740991 <= value <= 9007199254740991
nextRunDate*|
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
dueDays*|
Range-9007199254740991 <= value <= 9007199254740991
mode*string
Value in"draft""send"
status*string
Value in"active""paused""ended"
notes*string|null
terms*string|null
generatedCount*integer
Range-9007199254740991 <= value <= 9007199254740991
lastRunAt*|
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
lastError*string|null
createdAt*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
Example Request
curl -X PATCH 'https://your-billleaf-api/v1/recurring-invoices/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
{  "id": "string",  "clientId": "string",  "clientName": "string",  "title": "string",  "currency": "string",  "lines": [    {      "description": "string",      "quantity": 1,      "unitPrice": 0,      "taxRateBps": 0    }  ],  "total": -9007199254740991,  "every": -9007199254740991,  "unit": "week",  "startDate": "2019-08-24",  "endDate": "2019-08-24",  "maxOccurrences": -9007199254740991,  "nextRunDate": "2019-08-24",  "dueDays": -9007199254740991,  "mode": "draft",  "status": "active",  "notes": "string",  "terms": "string",  "generatedCount": -9007199254740991,  "lastRunAt": "2019-08-24T14:15:22Z",  "lastError": "string",  "createdAt": "2019-08-24T14:15:22Z"}