# Embeddings Admin

Administrative endpoints for managing vector embeddings used in AI-powered features such as semantic search and content recommendations. Provides tools for enabling/disabling embeddings, configuring the embedding model, estimating costs, and managing batch recalculation jobs. Requires AdminSettings.Manage permission.

## Disable embeddings

 - [PUT /api/v1/admin/embeddings/disable](https://docs.wellesley.social/openapi/embeddings-admin/paths/~1api~1v1~1admin~1embeddings~1disable/put.md): Disables embedding generation while preserving the model configuration. Existing embeddings are kept. Re-enabling with the same model will only recalculate missing embeddings.

RBAC: requires AdminSettings.Manage

## Enable embeddings

 - [PUT /api/v1/admin/embeddings/enable](https://docs.wellesley.social/openapi/embeddings-admin/paths/~1api~1v1~1admin~1embeddings~1enable/put.md): Enables embedding generation and starts recalculation. If no modelId is provided, uses the previously configured model. If modelId matches current model, only recalculates posts without embeddings. If modelId is different, clears all embeddings and recalculates all posts.

RBAC: requires AdminSettings.Manage

## Estimate embedding cost

 - [GET /api/v1/admin/embeddings/estimate-cost](https://docs.wellesley.social/openapi/embeddings-admin/paths/~1api~1v1~1admin~1embeddings~1estimate-cost/get.md): Estimates the cost of generating embeddings for posts. If no modelId is provided, uses the currently configured model. Returns whether this is a full recalculation (different model) or partial (only missing).

RBAC: requires AdminSettings.Manage

## Cancel recalculation

 - [DELETE /api/v1/admin/embeddings/recalculation](https://docs.wellesley.social/openapi/embeddings-admin/paths/~1api~1v1~1admin~1embeddings~1recalculation/delete.md): Cancels any active embedding recalculation job. Returns the updated status showing the job as cancelled.

RBAC: requires AdminSettings.Manage

## Get embedding system status

 - [GET /api/v1/admin/embeddings/status](https://docs.wellesley.social/openapi/embeddings-admin/paths/~1api~1v1~1admin~1embeddings~1status/get.md): Returns complete embedding system status including enabled state, model configuration, post statistics, and current recalculation progress if any.

RBAC: requires AdminSettings.Manage