Saltar al contenido principal
PATCH
cURL
Usa este endpoint para mantener cada aplicación alineada con el cliente, la marca, el entorno o el caso de uso interno que representa. Si eres revendedor, puedes renombrar o actualizar la aplicación de cada cliente sin compartir credenciales entre clientes. Si eres cliente directo, te ayuda a separar productos, regiones o entornos y a mantenerlo todo dentro de una sola organización.
Este endpoint actualiza los metadatos de la aplicación. La api_key no cambia, salvo que rotes las credenciales por separado.

Autorizaciones

Authorization
string
header
requerido

JWT access_token firmado con RS256 que devuelve POST /programmatic/login/ o POST /programmatic/verify-email/. Envíalo como Authorization: Bearer <access_token>. La vida útil predeterminada es de 86400 segundos (24 h). Este token solo es válido para los endpoints de gestión de cuentas en apx.didit.me/auth/v2. La API de verificación (verification.didit.me/v3) usa en su lugar la api_key de larga duración como x-api-key.

Parámetros de ruta

org_id
string<uuid>
requerido

UUID de la organización propietaria de la aplicación.

Ejemplo:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
requerido

UUID de la aplicación que se va a actualizar.

Ejemplo:

"b2c3d4e5-6789-01bc-defg-222222222222"

Cuerpo

application/json

Envía solo los campos que quieras cambiar. Semántica PATCH: los campos que faltan se conservan.

Cuerpo PATCH para los metadatos de la aplicación. Envía solo los campos que quieras cambiar; los campos omitidos se conservan. uuid, client_id y api_key no se pueden actualizar. products es de solo lectura: se ignora cualquier clave products en el cuerpo.

name
string

Nombre visible de la aplicación.

Ejemplo:

"Acme Production App"

website_url
string

URL del sitio web o de la app asociada a esta aplicación.

Ejemplo:

"https://app.acme.example"

redirect_uris
string[]

URI de redirección permitidas para los flujos de redirección de tipo OAuth y de verificación.

Ejemplo:
terms_url
string

URL de los términos del servicio que se muestra en el flujo de verificación.

privacy_url
string

URL de la política de privacidad que se muestra en el flujo de verificación.

description
string

Descripción interna de la aplicación.

Respuesta

Aplicación actualizada. La respuesta es el registro completo de la aplicación tras el cambio, incluidos los products; uuid, client_id y api_key no cambian.

Registro completo de la aplicación. uuid, client_id y api_key nunca cambian después de la creación.

uuid
string<uuid>

UUID de la aplicación. Úsalo como {app_id} en las llamadas posteriores.

Ejemplo:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Nombre visible de la aplicación que se muestra en la consola de Didit.

Ejemplo:

"Acme Production App"

client_id
string

Identificador público del cliente, seguro para incrustarlo en flujos de tipo OAuth.

Ejemplo:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Secreto de larga duración (también llamado client_secret). Úsalo como encabezado x-api-key en todas las llamadas a https://verification.didit.me/v3/... (sesiones, flujos, AML, etc.). Trátalo como una credencial; nunca lo expongas en el lado del cliente. Las claves nuevas empiezan por sk_live_ (aplicación de producción) o sk_test_ (aplicación de sandbox), seguidas de 43 caracteres seguros para URL (letras, dígitos, - y _). Las claves creadas antes de este formato no tienen prefijo y siguen funcionando sin cambios. Durante las 72 horas posteriores a la recuperación de tu cuenta, las operaciones de listar, obtener y actualizar devuelven aquí una cadena vacía en lugar de la clave.

Ejemplo:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL del sitio web o de la app asociada a esta aplicación.

Ejemplo:

"https://acme.example"

redirect_uris
string[]

URI de redirección permitidas para los flujos de redirección de tipo OAuth y de verificación.

Ejemplo:
terms_url
string | null

URL de los términos del servicio que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/terms"

privacy_url
string | null

URL de la política de privacidad que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/privacy"

description
string | null

Descripción interna de la aplicación (no se muestra a los usuarios finales).

created_at
string<date-time>
Ejemplo:

"2025-06-01T10:00:00Z"

products
object[]
read-only

Los productos de la aplicación. Siempre los tres, en este orden: identity, transactions, authentication. Una aplicación nueva tiene identity habilitado con todos los módulos activados, y transactions y authentication deshabilitados. Solo lectura: una clave products en el cuerpo de una creación o actualización se ignora.

Ejemplo:
Última modificación el 1 de noviembre de 2026