docs/api_reference.md

API Reference

Authentication

POST /v1/token

Query params:

• username (optional, default: admin)

Response:

{"access_token":"<jwt>"}

Use Authorization: Bearer <jwt> for protected endpoints.

Enrollment

POST /v1/enroll

Body:

{"identity_id":"u1","image_b64":"...","metadata":{"dept":"R&D"}}

Response:

{"identity_id":"u1","indexed":true,"embedding_dim":512}

Search

POST /v1/search

Body:

{"image_b64":"...","top_k":5}

Identity Metadata

GET /v1/identity/{id}

Returns metadata for enrolled identity.

Health

• GET /healthz on each service.
• POST /snapshot on vector-search to force index persistence.