# Venezuela Te Ayuda

- [Introducción](https://docs.venezuelateayuda.com/docs/api/index.md): Cómo usar la API de VENEZUELA TE BUSCA.
- [Autenticación](https://docs.venezuelateayuda.com/docs/api/authentication.md): Cómo autenticar llamadas a la API.
- [Acceso](https://docs.venezuelateayuda.com/docs/api/access.md): Cómo se controla el acceso a la API.
- [Errores](https://docs.venezuelateayuda.com/docs/api/errors.md): Formato de errores, códigos HTTP y límites de uso.
- [Paginación y filtros](https://docs.venezuelateayuda.com/docs/api/pagination.md): Cómo listar datos con cursor, filtros y orden.
- [Personas](https://docs.venezuelateayuda.com/docs/api/persons.md): Reglas importantes para crear y actualizar personas.
- [Duplicados](https://docs.venezuelateayuda.com/docs/api/duplicates.md): Flujo API para revisar, unificar o descartar candidatos duplicados.
- [Recursos](https://docs.venezuelateayuda.com/docs/api/resources.md): Cómo crear y mantener recursos de apoyo.
- [Get public registry metrics](https://docs.venezuelateayuda.com/api-reference/metrics/get-public-registry-metrics.md)
- [List resources](https://docs.venezuelateayuda.com/api-reference/resources/list-resources.md)
- [Create a resource](https://docs.venezuelateayuda.com/api-reference/resources/create-a-resource.md)
- [Get a resource](https://docs.venezuelateayuda.com/api-reference/resources/get-a-resource.md)
- [Delete a resource](https://docs.venezuelateayuda.com/api-reference/resources/delete-a-resource.md)
- [Update a resource](https://docs.venezuelateayuda.com/api-reference/resources/update-a-resource.md)
- [List persons](https://docs.venezuelateayuda.com/api-reference/persons/list-persons.md): Requires persons:read. Lists public persons across sources; individual person endpoints require source ownership. Sensitive response fields require persons:sensitive:read. A cursor request may include only cursor and limit.
- [Create a public person](https://docs.venezuelateayuda.com/api-reference/persons/create-a-public-person.md): Requires persons:write. The source is inferred from the API key. Send an unwrapped JSON object; source and unknown fields are rejected. Responses apply the caller’s sensitive-data permissions.
- [Get a person](https://docs.venezuelateayuda.com/api-reference/persons/get-a-person.md): Requires persons:read and a source row matching the API key. Private, removed, and other-source persons return 404. Sensitive fields require persons:sensitive:read.
- [Delete a public person](https://docs.venezuelateayuda.com/api-reference/persons/delete-a-public-person.md): Requires persons:write and matching source ownership. Existing minor or health-sensitive records also require persons:sensitive:read. Soft-deletes the person and removes its photo. A person referenced by merged records cannot be deleted and returns 409.
- [Update a public person](https://docs.venezuelateayuda.com/api-reference/persons/update-a-public-person.md): Requires persons:write and matching source ownership. Existing minor or health-sensitive records also require persons:sensitive:read. Person visibility and permissions are checked before the JSON body is validated.
- [Create or update by external source identifier](https://docs.venezuelateayuda.com/api-reference/persons/create-or-update-by-external-source-identifier.md): Requires persons:write. Uses the complete creation schema on both branches, validating it before looking up the source record. A match updates an existing public person; a private match returns 404. Existing sensitive records do not require persons:sensitive:read for this endpoint, but that permissi…
- [List person tips](https://docs.venezuelateayuda.com/api-reference/tips/list-person-tips.md)
- [Create a person tip](https://docs.venezuelateayuda.com/api-reference/tips/create-a-person-tip.md): Requires tips:write and a public parent belonging to the API key source. Minor authors are minimized and sender_phone is null unless persons:sensitive:read is granted.
- [Get a person tip](https://docs.venezuelateayuda.com/api-reference/tips/get-a-person-tip.md)
- [Delete a person tip](https://docs.venezuelateayuda.com/api-reference/tips/delete-a-person-tip.md): Requires tips:write and a public parent belonging to the API key source. Minor authors are minimized and sender_phone is null unless persons:sensitive:read is granted.
- [Update a person tip](https://docs.venezuelateayuda.com/api-reference/tips/update-a-person-tip.md): Requires tips:write and a public parent belonging to the API key source. Minor authors are minimized and sender_phone is null unless persons:sensitive:read is granted.
- [List person reports](https://docs.venezuelateayuda.com/api-reference/reports/list-person-reports.md): Lists active pending reports in created_at desc order. Only limit and cursor are accepted; cursors are scoped to the parent person.
- [Create a person report](https://docs.venezuelateayuda.com/api-reference/reports/create-a-person-report.md): Requires reports:write and a public parent belonging to the API key source. Item operations only find active pending reports; after status becomes completed, GET, PATCH and DELETE return 404.
- [Get a person report](https://docs.venezuelateayuda.com/api-reference/reports/get-a-person-report.md)
- [Delete a person report](https://docs.venezuelateayuda.com/api-reference/reports/delete-a-person-report.md): Requires reports:write and a public parent belonging to the API key source. Item operations only find active pending reports; after status becomes completed, GET, PATCH and DELETE return 404.
- [Update a person report](https://docs.venezuelateayuda.com/api-reference/reports/update-a-person-report.md): Requires reports:write and a public parent belonging to the API key source. Item operations only find active pending reports; after status becomes completed, GET, PATCH and DELETE return 404.
- [List duplicate reviews](https://docs.venezuelateayuda.com/api-reference/duplicates/list-duplicate-reviews.md): Requires duplicates:read. Defaults to all statuses and does not expand persons. Review lists are not restricted to the API key’s source; a listed review can still be unavailable from its detail or write endpoints.
- [Get a duplicate review](https://docs.venezuelateayuda.com/api-reference/duplicates/get-a-duplicate-review.md): Requires duplicates:read. Returns 404 when any existing candidate is private. Public candidates are minimized unless the API key has persons:sensitive:read. Reviews are not restricted to the API key’s source.
- [Merge selected duplicate candidates](https://docs.venezuelateayuda.com/api-reference/duplicates/merge-selected-duplicate-candidates.md): Requires duplicates:write. Only pending reviews can be merged. Reviews containing a minor or health-sensitive person also require persons:sensitive:read, checked before private-candidate visibility; private candidates otherwise return 404. The source of the API key does not restrict reviews. Send at…
- [Dismiss a duplicate review](https://docs.venezuelateayuda.com/api-reference/duplicates/dismiss-a-duplicate-review.md): Requires duplicates:write. Only pending reviews can be dismissed; closed reviews return 404. Reviews containing a minor or health-sensitive person also require persons:sensitive:read, checked before private-candidate visibility; private candidates otherwise return 404. No body is required. Persons a…
- [Upload or replace a person photo](https://docs.venezuelateayuda.com/api-reference/photos/upload-or-replace-a-person-photo.md): Requires persons:write and matching source ownership. Existing minor or health-sensitive records also require persons:sensitive:read. Accepts a WebP file no larger than 5 MiB (5,242,880 bytes); clients must convert other formats before uploading.
- [Remove a person photo](https://docs.venezuelateayuda.com/api-reference/photos/remove-a-person-photo.md): Requires persons:write and matching source ownership. Existing minor or health-sensitive records also require persons:sensitive:read. Clears the photo reference and deletes the old object; an already empty photo is accepted.
- [Preparar e importar listas de personas](https://docs.venezuelateayuda.com/docs/guides/importar-listas-de-personas.md): Formato único para convertir listas, imágenes y hojas de cálculo en un CSV válido e importarlo desde admin.
- [Service Bindings y sesiones](https://docs.venezuelateayuda.com/docs/api/service-bindings.md): Transporte interno, verificación de sesiones y estado de la migración.
- [Runtime, importación y sincronización](https://docs.venezuelateayuda.com/docs/guides/runtime-y-sincronizacion.md): Responsabilidades del monorepo y comportamiento de los procesos de datos.

## OpenAPI Specs

- [openapi](/docs/api/openapi.yaml)