Equip, claus i logs a l'eix de compte

11 d’octubre de 2026

L’eix de compte (/v1/accounts/{account}/…) ara diu qui ha fet què i quan, perquè una integració pugui mostrar la mateixa imatge que l’app a Equip i Desenvolupadors. Tot el d’aquesta pàgina és additiu: no s’ha retirat res i cap camp existent canvia de significat.

Ús diari d’una API key

getAccountApiKeyUsage (GET /v1/accounts/{account}/api-keys/{api_key}/usage, scope account:read) retorna l’ús d’una clau en els darrers 7, 30 (per defecte) o 90 dies amb el paràmetre de consulta days. Qualsevol altre valor respon 422.

data.daily té un element per dia, del més antic al més recent, amb requests_count, successful_count, client_error_count, rate_limited_count i error_count; els dies sense peticions apareixen amb tots els comptadors a 0. data.total suma el període, i last_used_at i last_used_ip indiquen quan i des d’on es va usar la clau per última vegada (null si mai no s’ha usat). Només retorna comptadors, mai quota, límits de tram ni preus. Una clau que no existeix, que és d’un altre compte o que arriba a un NIF fora de la vostra credencial respon el mateix 404 api_key_not_found. La tool MCP és get_api_key_usage.

API keys: restriccions, autoria i rotació

Les operacions de claus (llistar, consultar, crear, revocar, rotar el secret i canviar els NIF) ara retornen:

• ip_allowlist i allowed_origins: les adreces IP o rangs i els orígens de navegador als quals està restringida la clau, o null.
• last_used_ip, al costat de last_used_at.
• nif_scope: els NIF als quals arriba la clau, cadascun com a {id, tax_id, name, access_level} amb access_level view o operate.
• created_by, revoked_by i revoke_reason: qui ha creat i qui ha revocat la clau, i per què.
• secret_rotated_at, secret_rotated_by i previous_secret_valid_until: quan es va rotar el secret per última vegada, qui ho va fer i fins quan continua autenticant el secret anterior.

Crear i rotar continuen retornant el secret una sola vegada, i només llavors. Una rotació feta amb una credencial d’API o amb el servidor MCP mai no anomena una persona: secret_rotated_by queda en null. Les tools MCP get_api_key i list_api_keys retornen els mateixos camps.

Membres i invitacions: quan

Els membres ara porten joined_at i last_access_at. El segon és una cota inferior: la suplantació de suport i els accessos OAuth o MCP no compten, així que un membre pot estar actiu sense que es mogui.

Les invitacions ara porten created_at, sent_at (la creació o l’últim reenviament) i invited_by, un objecte {id, name} que és null quan aquesta persona ja no pertany al compte. Les tools de membres i invitacions a MCP també els retornen.

Logs de peticions: empresa, eix i filtres

Els logs de peticions del compte i d’una empresa ara diuen sobre quin NIF ha actuat cada petició i en quin eix:

• company: {id, tax_id, name}, o null quan la petició no ha actuat sobre una empresa.
• axis: company o account, derivat del prefix de la ruta.

Els dos llistats accepten el filtre nou company=<uuid>, que limita els logs a una empresa; una empresa fora del vostre àmbit respon 422 invalid_param_value amb param company. El llistat del compte accepta a més relationship=own|client, que limita els logs als vostres propis NIF o als de comptes client. Les quatre tools de logs a MCP retornen els camps nous i accepten els filtres de la seva operació.

Dominis de retorn de Stripe Connect

La llista de dominis de retorn ara porta meta.max (20), el màxim de dominis que un compte pot registrar. La llista està completa quan has_more és false, així que data davant max indica quantes places queden.

Correcció: un endpoint de webhook desactivat es pot reactivar

La guia de webhooks de compte deia que un endpoint desactivat no es podia tornar a activar. Sí que es pot: envieu PATCH amb status: active i l’endpoint torna a rebre esdeveniments. La guia i les descripcions de MCP ja ho diuen.

KeyRound

API keys

UsersRound

Comptes i NIF

Webhook

Webhooks de compte