admin

📄️ Read-only ops view of Zoho Books invoice export rows for an org.

Read-only ops view of Zoho Books invoice export rows for an org.

📄️ Approve a pending catalog sync entry, triggering catalog upsert (family, variant, and version creation or linking). Re-a

Approve a pending catalog sync entry, triggering catalog upsert (family, variant, and version creation or linking). Re-approving an already-mapped entry is a no-op at the catalog layer. Returns 404 if the entry does not exist. Requires JWT auth with admin or owner role.

📄️ Create a new provider catalog sync source. Returns the created source with 201. Requires JWT auth with admin or owner ro

Create a new provider catalog sync source. Returns the created source with 201. Requires JWT auth with admin or owner role. auth_config is write-only (credentials are not returned in subsequent GET responses).

📄️ List all provider catalog sync sources (e.g. HuggingFace). Returns every source ordered by provider_type. No pagination

List all provider catalog sync sources (e.g. HuggingFace). Returns every source ordered by provider_type. No pagination — source count is bounded by registered providers. Requires JWT auth with admin or owner role.

📄️ Delete a catalog sync source. Returns 204 No Content on success. Returns 404 if the source does not exist. Requires JWT

Delete a catalog sync source. Returns 204 No Content on success. Returns 404 if the source does not exist. Requires JWT auth with admin or owner role.

📄️ Partially update a catalog sync source. Only supplied fields are updated (exclude_unset semantics). Requires JWT auth wi

Partially update a catalog sync source. Only supplied fields are updated (exclude_unset semantics). Requires JWT auth with admin or owner role. Returns 404 if the source does not exist.

📄️ Fetch a single catalog sync run by ID. Returns 404 if the run does not exist. Requires JWT auth with admin or owner role

Fetch a single catalog sync run by ID. Returns 404 if the run does not exist. Requires JWT auth with admin or owner role.

📄️ Return an aggregate health summary across all catalog sync sources. Always returns 200 even when all sources are in erro

Return an aggregate health summary across all catalog sync sources. Always returns 200 even when all sources are in error state — health status is embedded in the payload. Requires JWT auth with admin or owner role.

📄️ List catalog sync entries discovered from an external source (e.g. HuggingFace). Supports filtering by mapping_status. U

List catalog sync entries discovered from an external source (e.g. HuggingFace). Supports filtering by mapping_status. Uses offset pagination (STYLE_GUIDE §4 grandfathered). Does not return 404 if source_id is unknown — returns empty array. Requires JWT auth with admin or owner role.

📄️ List the most recent sync runs for a catalog sync source, ordered by started_at descending. Hardcoded limit of 50 runs.

List the most recent sync runs for a catalog sync source, ordered by started_at descending. Hardcoded limit of 50 runs. Does not return 404 if the source_id is unknown — returns an empty array. Requires JWT auth with admin or owner role.

📄️ Trigger a manual catalog sync for the given source. Enqueues a background job (priority=600) and returns 202 with the jo

Trigger a manual catalog sync for the given source. Enqueues a background job (priority=600) and returns 202 with the job_id immediately. The resulting CatalogSyncRun will have trigger='manual'. Requires JWT auth with admin or owner role.

📄️ Create a curated mapping from an internal catalog variant to a cloud provider model ID. Returns 201 with the created map

Create a curated mapping from an internal catalog variant to a cloud provider model ID. Returns 201 with the created mapping. mapping_type defaults to 'curated' for manually created mappings. Requires JWT auth with admin or owner role.

📄️ List all variant-to-cloud-model mappings, ordered by created_at descending. No pagination — mapping count is bounded by

List all variant-to-cloud-model mappings, ordered by created_at descending. No pagination — mapping count is bounded by the number of catalog variants. Requires JWT auth with admin or owner role.

📄️ Create a new cloud provider catalog source. Returns the created source with 201. provider_key must be unique across all

Create a new cloud provider catalog source. Returns the created source with 201. provider_key must be unique across all cloud catalog sources. Requires JWT auth with admin or owner role.

📄️ List all cloud provider catalog sources (e.g. OpenAI, Anthropic), ordered by provider_key. No pagination — source count

List all cloud provider catalog sources (e.g. OpenAI, Anthropic), ordered by provider_key. No pagination — source count is bounded by registered cloud providers. Requires JWT auth with admin or owner role.

📄️ Delete a variant-to-cloud-model mapping. Returns 204 No Content on success. Returns 404 if the mapping does not exist. R

Delete a variant-to-cloud-model mapping. Returns 204 No Content on success. Returns 404 if the mapping does not exist. Requires JWT auth with admin or owner role.

📄️ Delete a cloud catalog source. Returns 204 No Content on success. Returns 404 if the source does not exist. Requires JWT

Delete a cloud catalog source. Returns 204 No Content on success. Returns 404 if the source does not exist. Requires JWT auth with admin or owner role.

📄️ Partially update a cloud catalog source. Only supplied fields are updated (exclude_unset semantics). provider_key is imm

Partially update a cloud catalog source. Only supplied fields are updated (exclude_unset semantics). provider_key is immutable. Returns 404 if the source does not exist. Requires JWT auth with admin or owner role.

📄️ Fetch a single cloud catalog sync run by ID. Returns 404 if the run does not exist. Requires JWT auth with admin or owne

Fetch a single cloud catalog sync run by ID. Returns 404 if the run does not exist. Requires JWT auth with admin or owner role.

📄️ Return an aggregate health summary across all cloud catalog sources. Always returns 200 — health status is embedded in t

Return an aggregate health summary across all cloud catalog sources. Always returns 200 — health status is embedded in the payload. total_models counts all CloudCatalogModel rows regardless of stale status. Requires JWT auth with admin or owner role.

📄️ List the most recent cloud catalog sync runs for a source, ordered by started_at descending. Hardcoded limit of 50 runs.

List the most recent cloud catalog sync runs for a source, ordered by started_at descending. Hardcoded limit of 50 runs. Does not return 404 if the source_id is unknown — returns an empty array. Requires JWT auth with admin or owner role.

📄️ List all cloud models for a source including stale ones.

List all cloud models for a source including stale ones.

📄️ Latest non-stale pricing per model for a source.

Latest non-stale pricing per model for a source.

📄️ Auto-suggest variant-to-cloud-model mappings. Results not persisted.

Auto-suggest variant-to-cloud-model mappings. Results not persisted.

📄️ Trigger a manual cloud catalog sync for the given source (both models and pricing phases). Enqueues a background job (pr

Trigger a manual cloud catalog sync for the given source (both models and pricing phases). Enqueues a background job (priority=500, phase='both') and returns 202 with job_id immediately. The resulting CloudCatalogSyncRun will have trigger='manual'. Requires JWT auth with admin or owner role.

📄️ Backfill device_class for NULL-classified devices. Safe to re-run.

Backfill device_class for NULL-classified devices. Safe to re-run.

📄️ Search and filter devices across the fleet for a given org. Supports filtering by device_identifier (partial ILIKE match

Search and filter devices across the fleet for a given org. Supports filtering by device_identifier (partial ILIKE match), app_version, active_model_version, platform, and status. Uses offset pagination (STYLE_GUIDE §4 grandfathered). Accepts JWT or API-key auth; requires devices:read scope in both cases.