Partially update an existing spending limit

curl --request PATCH \
  --url https://tracer.sandbox.lerian.net/v1/limits/{limit_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "activeTimeEnd": "17:00",
  "activeTimeStart": "09:00",
  "customEndDate": "2026-11-29T00:00:00Z",
  "customStartDate": "2026-11-27T00:00:00Z",
  "description": "<string>",
  "maxAmount": "1000.00",
  "name": "<string>",
  "scopes": [
    {
      "accountId": "00000000-0000-0000-0000-000000000000",
      "merchantId": "00000000-0000-0000-0000-000000000000",
      "portfolioId": "00000000-0000-0000-0000-000000000000",
      "scheme": "PIX",
      "segmentId": "00000000-0000-0000-0000-000000000000",
      "subType": "purchase",
      "transactionType": "PIX"
    }
  ]
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/limits/{limit_id}"

	payload := strings.NewReader("{\n  \"activeTimeEnd\": \"17:00\",\n  \"activeTimeStart\": \"09:00\",\n  \"customEndDate\": \"2026-11-29T00:00:00Z\",\n  \"customStartDate\": \"2026-11-27T00:00:00Z\",\n  \"description\": \"<string>\",\n  \"maxAmount\": \"1000.00\",\n  \"name\": \"<string>\",\n  \"scopes\": [\n    {\n      \"accountId\": \"00000000-0000-0000-0000-000000000000\",\n      \"merchantId\": \"00000000-0000-0000-0000-000000000000\",\n      \"portfolioId\": \"00000000-0000-0000-0000-000000000000\",\n      \"scheme\": \"PIX\",\n      \"segmentId\": \"00000000-0000-0000-0000-000000000000\",\n      \"subType\": \"purchase\",\n      \"transactionType\": \"PIX\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    activeTimeEnd: '17:00',
    activeTimeStart: '09:00',
    customEndDate: '2026-11-29T00:00:00Z',
    customStartDate: '2026-11-27T00:00:00Z',
    description: '<string>',
    maxAmount: '1000.00',
    name: '<string>',
    scopes: [
      {
        accountId: '00000000-0000-0000-0000-000000000000',
        merchantId: '00000000-0000-0000-0000-000000000000',
        portfolioId: '00000000-0000-0000-0000-000000000000',
        scheme: 'PIX',
        segmentId: '00000000-0000-0000-0000-000000000000',
        subType: 'purchase',
        transactionType: 'PIX'
      }
    ]
  })
};

fetch('https://tracer.sandbox.lerian.net/v1/limits/{limit_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://tracer.sandbox.lerian.net/v1/limits/{limit_id}"

payload = {
    "activeTimeEnd": "17:00",
    "activeTimeStart": "09:00",
    "customEndDate": "2026-11-29T00:00:00Z",
    "customStartDate": "2026-11-27T00:00:00Z",
    "description": "<string>",
    "maxAmount": "1000.00",
    "name": "<string>",
    "scopes": [
        {
            "accountId": "00000000-0000-0000-0000-000000000000",
            "merchantId": "00000000-0000-0000-0000-000000000000",
            "portfolioId": "00000000-0000-0000-0000-000000000000",
            "scheme": "PIX",
            "segmentId": "00000000-0000-0000-0000-000000000000",
            "subType": "purchase",
            "transactionType": "PIX"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "asset": "USD",
  "createdAt": "2021-01-01T00:00:00Z",
  "limitId": "00000000-0000-0000-0000-000000000000",
  "limitType": "DAILY",
  "maxAmount": "1000.00",
  "name": "Daily USD spending cap",
  "scopes": [
    {
      "accountId": "00000000-0000-0000-0000-000000000000",
      "merchantId": "00000000-0000-0000-0000-000000000000",
      "portfolioId": "00000000-0000-0000-0000-000000000000",
      "scheme": "PIX",
      "segmentId": "00000000-0000-0000-0000-000000000000",
      "subType": "purchase",
      "transactionType": "PIX"
    }
  ],
  "status": "ACTIVE",
  "updatedAt": "2021-01-01T00:00:00Z",
  "activeTimeEnd": "17:00",
  "activeTimeStart": "09:00",
  "customEndDate": "2021-12-31T23:59:59Z",
  "customStartDate": "2021-01-01T00:00:00Z",
  "deletedAt": "2021-01-01T00:00:00Z",
  "description": "Caps daily USD outflows for retail accounts",
  "resetAt": "2021-01-02T00:00:00Z",
  "resetTime": "09:00"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

PATCH

limits

{limit_id}

Partially update an existing spending limit

curl --request PATCH \
  --url https://tracer.sandbox.lerian.net/v1/limits/{limit_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "activeTimeEnd": "17:00",
  "activeTimeStart": "09:00",
  "customEndDate": "2026-11-29T00:00:00Z",
  "customStartDate": "2026-11-27T00:00:00Z",
  "description": "<string>",
  "maxAmount": "1000.00",
  "name": "<string>",
  "scopes": [
    {
      "accountId": "00000000-0000-0000-0000-000000000000",
      "merchantId": "00000000-0000-0000-0000-000000000000",
      "portfolioId": "00000000-0000-0000-0000-000000000000",
      "scheme": "PIX",
      "segmentId": "00000000-0000-0000-0000-000000000000",
      "subType": "purchase",
      "transactionType": "PIX"
    }
  ]
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/limits/{limit_id}"

	payload := strings.NewReader("{\n  \"activeTimeEnd\": \"17:00\",\n  \"activeTimeStart\": \"09:00\",\n  \"customEndDate\": \"2026-11-29T00:00:00Z\",\n  \"customStartDate\": \"2026-11-27T00:00:00Z\",\n  \"description\": \"<string>\",\n  \"maxAmount\": \"1000.00\",\n  \"name\": \"<string>\",\n  \"scopes\": [\n    {\n      \"accountId\": \"00000000-0000-0000-0000-000000000000\",\n      \"merchantId\": \"00000000-0000-0000-0000-000000000000\",\n      \"portfolioId\": \"00000000-0000-0000-0000-000000000000\",\n      \"scheme\": \"PIX\",\n      \"segmentId\": \"00000000-0000-0000-0000-000000000000\",\n      \"subType\": \"purchase\",\n      \"transactionType\": \"PIX\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    activeTimeEnd: '17:00',
    activeTimeStart: '09:00',
    customEndDate: '2026-11-29T00:00:00Z',
    customStartDate: '2026-11-27T00:00:00Z',
    description: '<string>',
    maxAmount: '1000.00',
    name: '<string>',
    scopes: [
      {
        accountId: '00000000-0000-0000-0000-000000000000',
        merchantId: '00000000-0000-0000-0000-000000000000',
        portfolioId: '00000000-0000-0000-0000-000000000000',
        scheme: 'PIX',
        segmentId: '00000000-0000-0000-0000-000000000000',
        subType: 'purchase',
        transactionType: 'PIX'
      }
    ]
  })
};

fetch('https://tracer.sandbox.lerian.net/v1/limits/{limit_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://tracer.sandbox.lerian.net/v1/limits/{limit_id}"

payload = {
    "activeTimeEnd": "17:00",
    "activeTimeStart": "09:00",
    "customEndDate": "2026-11-29T00:00:00Z",
    "customStartDate": "2026-11-27T00:00:00Z",
    "description": "<string>",
    "maxAmount": "1000.00",
    "name": "<string>",
    "scopes": [
        {
            "accountId": "00000000-0000-0000-0000-000000000000",
            "merchantId": "00000000-0000-0000-0000-000000000000",
            "portfolioId": "00000000-0000-0000-0000-000000000000",
            "scheme": "PIX",
            "segmentId": "00000000-0000-0000-0000-000000000000",
            "subType": "purchase",
            "transactionType": "PIX"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "asset": "USD",
  "createdAt": "2021-01-01T00:00:00Z",
  "limitId": "00000000-0000-0000-0000-000000000000",
  "limitType": "DAILY",
  "maxAmount": "1000.00",
  "name": "Daily USD spending cap",
  "scopes": [
    {
      "accountId": "00000000-0000-0000-0000-000000000000",
      "merchantId": "00000000-0000-0000-0000-000000000000",
      "portfolioId": "00000000-0000-0000-0000-000000000000",
      "scheme": "PIX",
      "segmentId": "00000000-0000-0000-0000-000000000000",
      "subType": "purchase",
      "transactionType": "PIX"
    }
  ],
  "status": "ACTIVE",
  "updatedAt": "2021-01-01T00:00:00Z",
  "activeTimeEnd": "17:00",
  "activeTimeStart": "09:00",
  "customEndDate": "2021-12-31T23:59:59Z",
  "customStartDate": "2021-01-01T00:00:00Z",
  "deletedAt": "2021-01-01T00:00:00Z",
  "description": "Caps daily USD outflows for retail accounts",
  "resetAt": "2021-01-02T00:00:00Z",
  "resetTime": "09:00"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

limit_id

string

requerido

Limit ID (UUID)

Cuerpo

application/json

activeTimeEnd

string | null

End of the daily time window (HH:MM). Send activeTimeStart and activeTimeEnd both as null to remove the window.

Ejemplo:

"17:00"

activeTimeStart

string | null

Start of the daily time window (HH:MM). Send activeTimeStart and activeTimeEnd both as null to remove the window.

Ejemplo:

"09:00"

customEndDate

string<date-time>

Ejemplo:

"2026-11-29T00:00:00Z"

customStartDate

string<date-time>

Ejemplo:

"2026-11-27T00:00:00Z"

description

string

Limit description, at most 1000 characters.

Maximum string length: 1000

maxAmount

string

Ejemplo:

"1000.00"

name

string

Limit name, 1 to 255 characters.

Required string length: 1 - 255

scopes

object[]

Show child attributes

Respuesta

asset

string

requerido

Ejemplo:

"USD"

createdAt

string<date-time>

requerido

Ejemplo:

"2021-01-01T00:00:00Z"

limitId

string<uuid>

requerido

Ejemplo:

"00000000-0000-0000-0000-000000000000"

limitType

string

requerido

Ejemplo:

"DAILY"

maxAmount

string

requerido

Ejemplo:

"1000.00"

name

string

requerido

Maximum string length: 255

Ejemplo:

"Daily USD spending cap"

scopes

object[] | null

requerido

Show child attributes

status

string

requerido

Ejemplo:

"ACTIVE"

updatedAt

string<date-time>

requerido

Ejemplo:

"2021-01-01T00:00:00Z"

activeTimeEnd

string

Ejemplo:

"17:00"

activeTimeStart

string

Ejemplo:

"09:00"

customEndDate

string<date-time>

Ejemplo:

"2021-12-31T23:59:59Z"

customStartDate

string<date-time>

Ejemplo:

"2021-01-01T00:00:00Z"

deletedAt

string<date-time>

Ejemplo:

"2021-01-01T00:00:00Z"

description

string

Ejemplo:

"Caps daily USD outflows for retail accounts"

resetAt

string<date-time>

Ejemplo:

"2021-01-02T00:00:00Z"

resetTime

string

Ejemplo:

"09:00"

Primeros pasos

API de Validaciones

API de Reglas

API de Límites

API de Eventos de Auditoría

API de Dashboards

Manejo de errores

Eventos

Partially update an existing spending limit

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta