PATCH /profiles/:profileId - ARGOS Identity

Solo cambian los campos que envía. Las carpetas y los ítems no se ven afectados.

Endpoint

PATCH /v1/profiles/{profileId}

Petición

Parámetros de ruta

Parámetro	Tipo	Descripción
`profileId`	`string`	ID del perfil a actualizar (prefijo `pf_`)

Cuerpo de la petición

Campo	Tipo	Descripción
`name`	`string`	Nombre del perfil
`description`	`string`	Descripción
`metadata`	`object`	Metadatos propios. Se sustituyen por completo, no se fusionan

curl -X PATCH "https://client-omni-api.argosidentity.com/v1/profiles/pf_6h4y8s2f0v9n" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example (re-review)",
    "metadata": { "vendor_id": "VND-2026-0142", "review_round": "2" }
  }'

Enviar metadata sustituye el objeto entero. Para cambiar una sola clave, envíe también todas las existentes.

Respuesta (200 OK)

{
  "id": "pf_6h4y8s2f0v9n",
  "workflowId": "wf_3p8k2m5r9v1t",
  "name": "example (re-review)",
  "description": "Example profile for document verification",
  "metadata": { "vendor_id": "VND-2026-0142", "review_round": "2" },
  "itemsCount": 3,
  "foldersCount": 1,
  "lastAnalysisAt": "2026-09-10T05:41:09.220Z",
  "createdAt": "2026-09-10T05:32:47.118Z",
  "updatedAt": "2026-09-10T05:54:10.551Z"
}

La respuesta tiene la misma forma que una entrada de items[] en listar perfiles. A diferencia de la lectura de un perfil, no incluye los arrays folders ni recentAnalyses.

Códigos de error

Estado	Código	Descripción
404	`OMNI_3005`	Perfil no encontrado

Los errores comunes (400 validación · 401 autenticación · 403 permisos · 500 servidor) están en la descripción general de la API.

⌘I