/api/v1/access-grants/{id}Modificare un'autorizzazione di accesso
Modifica etichetta, scopo, prova, scadenza o ambito di un'autorizzazione attiva. Inviate solo le chiavi da cambiare, almeno una. Il ruolo non può essere cambiato: revocate l'autorizzazione e createne una nuova. Un'autorizzazione di un'autorità (ruolo di autorità o livello authority) si può modificare solo nella dashboard: tramite API risponde 400 role_dashboard_only.
Spostare in avanti la scadenza di un'autorizzazione scaduta la rende di nuovo attiva e vale il limite di 50 autorizzazioni attive come alla creazione. Un'autorizzazione revocata risponde 404. La modifica è scritta nel registro degli accessi con la chiave API o l'app che l'ha fatta.
Chi può chiamarlo. Una chiave API solo se il suo titolare ha attivato «May manage access grants» per quella chiave nella pagina Developer (disattivato per impostazione predefinita; altrimenti 403 access_grants_not_enabled). Un token OAuth richiede lo scope access_grants:write e un utente admin o owner. Richiede un account a pagamento. Conta come una scrittura v1. Rispetta Idempotency-Key.
Parametri di percorso
- idobbligatorio
string (24 hex chars)
ID dell'autorizzazione di accesso.
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
- Idempotency-Key
string
UUID v4.
Campi del corpo
- label
string (1-120 chars)
Nuova etichetta.
- purpose
string (max 500 chars)
Nuovo scopo.
- scope
object
Nuovo ambito, stessa forma della creazione. Un'autorizzazione da acquirente deve restare sui passaporti.
- evidence
object
Nuova prova
{ type, reference, note? }. - expiresInDays
integer | null (1-1825)
Giorni da ora alla scadenza;
null= nessuna scadenza.
Richiesta
curl -sS -X PATCH https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0 \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "expiresInDays": 90 }'Risposta
{
"data": {
"id": "6650c1d2e3f4a5b6c7d8e9f0",
"accessLevel": "restricted",
"label": "Buyer GmbH, order 4711",
"role": "purchaser",
"scope": { "kind": "passports", "ids": ["6650a1b2c3d4e5f6a7b8c9d0"] },
"purpose": null,
"evidence": null,
"state": "active",
"expiresAt": null,
"useCount": 0,
"createdAt": "2026-06-01T09:30:00.000Z"
}
}