cURL
curl --request PUT \
--url https://www.pierre.finance/tools/api/update-payment-reminder \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reminderId": "<string>",
"title": "<string>",
"amount": 123,
"dueDate": "2023-12-25",
"reminderTime": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://www.pierre.finance/tools/api/update-payment-reminder"
payload = {
"reminderId": "<string>",
"title": "<string>",
"amount": 123,
"dueDate": "2023-12-25",
"reminderTime": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reminderId: '<string>',
title: '<string>',
amount: 123,
dueDate: '2023-12-25',
reminderTime: '2023-11-07T05:31:56Z'
})
};
fetch('https://www.pierre.finance/tools/api/update-payment-reminder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.pierre.finance/tools/api/update-payment-reminder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'reminderId' => '<string>',
'title' => '<string>',
'amount' => 123,
'dueDate' => '2023-12-25',
'reminderTime' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.pierre.finance/tools/api/update-payment-reminder"
payload := strings.NewReader("{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("PUT", 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))
}HttpResponse<String> response = Unirest.put("https://www.pierre.finance/tools/api/update-payment-reminder")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.pierre.finance/tools/api/update-payment-reminder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "pr_123456789",
"title": "Conta de luz - Residência",
"amount": 180.00,
"dueDate": "2024-12-20",
"reminderTime": "2024-12-19T09:00:00Z",
"recurrenceTime": "9h",
"status": "active",
"isRecurring": false,
"recurrencePattern": null,
"createdAt": "2024-11-20T10:00:00Z",
"updatedAt": "2024-11-27T16:00:00Z"
},
"message": "Payment reminder updated successfully",
"timestamp": "2024-11-27T16:00:00Z"
}
Payment Reminders
Update Payment Reminder
Atualiza um lembrete de pagamento existente. Permite modificar título, valor, datas, padrão de recorrência e status. O usuário só pode atualizar seus próprios lembretes. Requer API key para autenticação e assinatura ativa.
PUT
/
tools
/
api
/
update-payment-reminder
cURL
curl --request PUT \
--url https://www.pierre.finance/tools/api/update-payment-reminder \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reminderId": "<string>",
"title": "<string>",
"amount": 123,
"dueDate": "2023-12-25",
"reminderTime": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://www.pierre.finance/tools/api/update-payment-reminder"
payload = {
"reminderId": "<string>",
"title": "<string>",
"amount": 123,
"dueDate": "2023-12-25",
"reminderTime": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reminderId: '<string>',
title: '<string>',
amount: 123,
dueDate: '2023-12-25',
reminderTime: '2023-11-07T05:31:56Z'
})
};
fetch('https://www.pierre.finance/tools/api/update-payment-reminder', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.pierre.finance/tools/api/update-payment-reminder",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'reminderId' => '<string>',
'title' => '<string>',
'amount' => 123,
'dueDate' => '2023-12-25',
'reminderTime' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.pierre.finance/tools/api/update-payment-reminder"
payload := strings.NewReader("{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("PUT", 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))
}HttpResponse<String> response = Unirest.put("https://www.pierre.finance/tools/api/update-payment-reminder")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.pierre.finance/tools/api/update-payment-reminder")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reminderId\": \"<string>\",\n \"title\": \"<string>\",\n \"amount\": 123,\n \"dueDate\": \"2023-12-25\",\n \"reminderTime\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "pr_123456789",
"title": "Conta de luz - Residência",
"amount": 180.00,
"dueDate": "2024-12-20",
"reminderTime": "2024-12-19T09:00:00Z",
"recurrenceTime": "9h",
"status": "active",
"isRecurring": false,
"recurrencePattern": null,
"createdAt": "2024-11-20T10:00:00Z",
"updatedAt": "2024-11-27T16:00:00Z"
},
"message": "Payment reminder updated successfully",
"timestamp": "2024-11-27T16:00:00Z"
}
Este endpoint atualiza um lembrete de pagamento existente.
Descrição
O endpointPUT /tools/api/update-payment-reminder permite modificar título, valor, datas, padrão de recorrência e status de lembretes de pagamento. O usuário só pode atualizar seus próprios lembretes.
Autenticação
Este endpoint requer autenticação via Bearer token.string
required
Bearer token com a API key do usuário. Formato:
Bearer sk-your-api-key-hereParâmetros de Query
string
required
Parâmetro interno para indicar requisições via MCP. Use
s=s para requisições MCP.Body Parameters
string
required
ID do lembrete a ser atualizado
string
Novo título do lembrete (opcional)
number
Novo valor do pagamento em BRL (opcional)
string
Nova data de vencimento no formato YYYY-MM-DD (opcional)
string
Nova data/hora do lembrete em formato ISO 8601 (opcional)
string
Novo horário de recorrência (ex: ‘8h’, ‘14h30’) (opcional)
string
Novo status:
active, completed, ou inactive (opcional)Resposta
Sucesso (200)
{
"success": true,
"data": {
"id": "pr_123456789",
"title": "Conta de luz - Residência",
"amount": 180.00,
"dueDate": "2024-12-20",
"reminderTime": "2024-12-19T09:00:00Z",
"recurrenceTime": "9h",
"status": "active",
"isRecurring": false,
"recurrencePattern": null,
"createdAt": "2024-11-20T10:00:00Z",
"updatedAt": "2024-11-27T16:00:00Z"
},
"message": "Payment reminder updated successfully",
"timestamp": "2024-11-27T16:00:00Z"
}
Erro de Validação (400)
{
"error": "Invalid or missing reminderId",
"message": "reminderId must be provided"
}
{
"error": "Invalid dueDate format",
"message": "dueDate must be in YYYY-MM-DD format"
}
Erro de Autenticação (401)
{
"error": "Invalid or inactive API key",
"message": "Please check your API key and try again",
"type": "invalid_api_key"
}
Erro de Acesso (403)
{
"error": "Unauthorized",
"message": "You do not have permission to update this reminder"
}
Lembrete Não Encontrado (404)
{
"error": "Reminder not found",
"message": "No reminder found with ID: pr_123456789"
}
Campos da Resposta
boolean
required
Indica se a requisição foi bem-sucedida
object
required
Objeto com os dados atualizados do lembrete
Show Payment Reminder Object
Show Payment Reminder Object
string
required
Identificador único do lembrete
string
required
Título atualizado do lembrete
number
Valor atualizado do pagamento em BRL
string
Data de vencimento atualizada (YYYY-MM-DD)
string
Data/hora atualizada do lembrete (ISO 8601)
string
Horário de recorrência atualizado
string
required
Status atualizado:
active, completed, ou inactiveboolean
required
Se o lembrete é recorrente
string
Padrão de recorrência
string
required
Data de criação original (ISO 8601)
string
required
Data da última atualização (ISO 8601)
string
required
Mensagem de confirmação da atualização
string
required
Timestamp da requisição em formato ISO 8601
Exemplos de Uso
cURL
# Atualizar título e valor
curl -X PUT 'https://www.pierre.finance/tools/api/update-payment-reminder' \
-H 'Authorization: Bearer sk-your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"reminderId": "pr_123456789",
"title": "Conta de luz - Residência",
"amount": 180.00
}'
# Atualizar data de vencimento
curl -X PUT 'https://www.pierre.finance/tools/api/update-payment-reminder' \
-H 'Authorization: Bearer sk-your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"reminderId": "pr_123456789",
"dueDate": "2024-12-20"
}'
# Marcar como completado
curl -X PUT 'https://www.pierre.finance/tools/api/update-payment-reminder' \
-H 'Authorization: Bearer sk-your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{
"reminderId": "pr_123456789",
"newStatus": "completed"
}'
JavaScript
const API_KEY = 'sk-your-api-key-here';
const BASE_URL = 'https://www.pierre.finance/tools/api';
async function updatePaymentReminder(reminderId, updates) {
const response = await fetch(`${BASE_URL}/update-payment-reminder`, {
method: 'PUT',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ reminderId, ...updates })
});
return await response.json();
}
// Exemplos de uso
updatePaymentReminder('pr_123456789', {
title: 'Conta de luz - Residência',
amount: 180
});
updatePaymentReminder('pr_123456789', {
dueDate: '2024-12-20'
});
updatePaymentReminder('pr_123456789', {
newStatus: 'completed'
});
Python
import requests
API_KEY = 'sk-your-api-key-here'
BASE_URL = 'https://www.pierre.finance/tools/api'
headers = {
'Authorization': f'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
def update_payment_reminder(reminder_id, **updates):
data = {'reminderId': reminder_id, **updates}
response = requests.put(f'{BASE_URL}/update-payment-reminder',
headers=headers, json=data)
return response.json()
# Exemplos de uso
update_payment_reminder('pr_123456789',
title='Conta de luz - Residência',
amount=180)
update_payment_reminder('pr_123456789',
dueDate='2024-12-20')
update_payment_reminder('pr_123456789',
newStatus='completed')
Códigos de Status
200: Sucesso - Lembrete atualizado400: Parâmetros inválidos401: Erro de autenticação ou assinatura403: Acesso negado - lembrete pertence a outro usuário404: Lembrete não encontrado500: Erro interno do servidor
Status Disponíveis
- active: Lembrete ativo e enviando notificações
- completed: Pagamento realizado, lembrete completado
- inactive: Lembrete desativado, não envia notificações
Ao marcar um lembrete como
completed, ele não conta mais para o limite de quota do plano. Lembretes recorrentes são renovados automaticamente mesmo após completados.Use
newStatus: 'inactive' para pausar temporariamente um lembrete sem excluí-lo. Você pode reativá-lo depois alterando o status para active.Authorizations
API key in Bearer token format. Example: Bearer sk-your-api-key-here
Body
application/json

