Metrics Reporting

Category: Admin Base URL: /admin/metrics Authentication: Required Routes: 43 routes documented

Overview

This section documents 43 API routes for metrics reporting.

⚠️ These endpoints operate on your live store. POST/PUT/DELETE operations here — including sync, push, resync, and cache operations — modify or delete production data, and some trigger downstream effects such as warehouse orders or customer emails. DELETE operations are generally irreversible. Verify IDs and parameters carefully before calling them from scripts.

Quick Reference

Method Endpoint Description
GET /admin/metrics GET /admin/metrics Rate limited to 60 requests per minute pe...
POST /admin/metrics POST /admin/metrics Rate limited to 10 requests per minute p...
POST /admin/metrics-registry/compute POST /admin/metrics-registry/compute Compute multiple metric...
GET /admin/metrics-registry/definitions GET /admin/metrics-registry/definitions List all metric defi...
POST /admin/metrics-registry/definitions POST /admin/metrics-registry/definitions Create a new metric...
GET /admin/metrics-registry/definitions/:id GET /admin/metrics-registry/definitions/:id Get a specific m...
PATCH /admin/metrics-registry/definitions/:id PATCH /admin/metrics-registry/definitions/:id Update a metri...
DELETE /admin/metrics-registry/definitions/:id DELETE /admin/metrics-registry/definitions/:id Soft delete a...
GET /admin/metrics-registry/definitions/:id/versions GET /admin/metrics-registry/definitions/:id/versions Get ver...
POST /admin/metrics-registry/definitions/:id/versions POST /admin/metrics-registry/definitions/:id/versions/rollba...
POST /admin/metrics-registry/execute POST /admin/metrics-registry/execute Execute a metric formul...
GET /admin/metrics-registry/placeholders GET /admin/metrics-registry/placeholders List all placeholde...
POST /admin/metrics-registry/placeholders POST /admin/metrics-registry/placeholders Create a new place...
POST /admin/metrics-registry/validate POST /admin/metrics-registry/validate Validate a formula and...
GET /admin/metrics/alerts GET /admin/metrics/alerts List all alerts
POST /admin/metrics/alerts POST /admin/metrics/alerts Create a new alert
GET /admin/metrics/alerts/:id GET /admin/metrics/alerts/:id Get a specific alert
POST /admin/metrics/alerts/:id POST /admin/metrics/alerts/:id Update an alert
DELETE /admin/metrics/alerts/:id DELETE /admin/metrics/alerts/:id Delete an alert
GET /admin/metrics/audit GET /admin/metrics/audit/recent Get recent changes across al...
POST /admin/metrics/audit POST /admin/metrics/audit/export Export audit trail for comp...
POST /admin/metrics/batch POST /admin/metrics/batch Compute multiple metrics in parall...
POST /admin/metrics/cache POST /admin/metrics/cache/warm Warm metrics cache for common...
DELETE /admin/metrics/cache DELETE /admin/metrics/cache Invalidate all metrics cache
GET /admin/metrics/cache GET /admin/metrics/cache/stats Get cache statistics
GET /admin/metrics/catalog GET /admin/metrics/catalog Search metrics catalog
POST /admin/metrics/catalog POST /admin/metrics/catalog Register new metric
GET /admin/metrics/catalog/:id GET /admin/metrics/catalog/:id Get metric by ID
PUT /admin/metrics/catalog/:id PUT /admin/metrics/catalog/:id Update metric
DELETE /admin/metrics/catalog/:id DELETE /admin/metrics/catalog/:id Archive metric (soft delet...
GET /admin/metrics/catalog/:id/dependencies GET /admin/metrics/catalog/:id/dependencies Get metric depen...
GET /admin/metrics/catalog/:id/dependents GET /admin/metrics/catalog/:id/dependents Get metrics that d...
POST /admin/metrics/catalog/:id/lifecycle POST /admin/metrics/catalog/:id/lifecycle Transition metric ...
GET /admin/metrics/catalog/:id/versions GET /admin/metrics/catalog/:id/versions Get metric version h...
POST /admin/metrics/catalog/seed-examples POST /admin/metrics/catalog/seed-examples Trigger the seed e...
POST /admin/metrics/catalog/validate POST /admin/metrics/catalog/validate Validate metric formula...
POST /admin/metrics/compute No description
GET /admin/metrics/dashboard No description
POST /admin/metrics/definitions POST /admin/metrics/definitions Create a new metric definiti...
GET /admin/metrics/definitions GET /admin/metrics/definitions List metric definitions with ...
GET /admin/metrics/definitions/:id GET /admin/metrics/definitions/:id Get a single metric defin...
PUT /admin/metrics/definitions/:id PUT /admin/metrics/definitions/:id Update a metric definitio...
DELETE /admin/metrics/definitions/:id DELETE /admin/metrics/definitions/:id Delete a metric defini...
POST /admin/metrics/fulfillment-report No description
GET /admin/metrics/performance GET /admin/metrics/performance Get current performance metri...
POST /admin/metrics/performance POST /admin/metrics/performance/report Generate and log perf...
GET /admin/metrics/performance/events GET /admin/metrics/performance/events Get recent computation...
GET /admin/metrics/placeholders GET /admin/metrics/placeholders List available placeholders
POST /admin/metrics/placeholders POST /admin/metrics/placeholders Create a new placeholder
GET /admin/metrics/rate-limit-status GET /admin/metrics/rate-limit-status Get rate limit metrics ...
DELETE /admin/metrics/rate-limit-status DELETE /admin/metrics/rate-limit-status Clear rate limit met...
POST /admin/metrics/report No description
GET /admin/metrics/reports No description
GET /admin/metrics/reports/top-products No description
GET /admin/metrics/suggestions GET /admin/metrics/suggestions Get AI-powered metric suggest...
GET /admin/metrics/templates GET /admin/metrics/templates List all metric templates
POST /admin/metrics/templates POST /admin/metrics/templates/:id/instantiate Create a metri...
GET /admin/metrics/templates/:id GET /admin/metrics/templates/:id Get a specific template
POST /admin/metrics/validate POST /admin/metrics/validate Validate a metric formula Rate ...
GET /admin/reports/cogs/alerts No description
GET /admin/reports/cogs/inventory-turnover No description
GET /admin/reports/cogs/margins No description
GET /admin/reports/cogs/snapshots No description
GET /admin/reports/taxes/dashboard No description
GET /admin/reports/taxes/export No description

GET Admin Metrics

Endpoint: GET /admin/metrics Authentication: Admin (Required)

Description

GET /admin/metrics Rate limited to 60 requests per minute per user

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics

Endpoint: POST /admin/metrics Authentication: Admin (Required)

Description

POST /admin/metrics Rate limited to 10 requests per minute per user

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Compute

Endpoint: POST /admin/metrics-registry/compute Authentication: Admin (Required)

Description

POST /admin/metrics-registry/compute Compute multiple metrics in a single request (batch computation) @example POST /admin/metrics-registry/compute { "requests": [ { "metric_id": "metric-123", "context": { "orderTotal": 1000 } }, { "metric_id": "metric-456", "context": { "customerCount": 50 } } ] } Response: { "results": [ { "metric_id": "metric-123", "result": 1200, "success": true, "execution_time_ms": 15 }, { "metric_id": "metric-456", "result": 75, "success": true, "execution_time_ms": 12 } ], "summary": { "total": 2, "succeeded": 2, "failed": 0, "total_execution_time_ms": 27 } }

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/compute' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics-registry Definitions

Endpoint: GET /admin/metrics-registry/definitions Authentication: Admin (Required)

Description

GET /admin/metrics-registry/definitions List all metric definitions with optional filtering

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics-registry/definitions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Definitions

Endpoint: POST /admin/metrics-registry/definitions Authentication: Admin (Required)

Description

POST /admin/metrics-registry/definitions Create a new metric definition

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/definitions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics-registry Definitions :id

Endpoint: GET /admin/metrics-registry/definitions/:id Authentication: Admin (Required)

Description

GET /admin/metrics-registry/definitions/:id Get a specific metric definition

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics-registry/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

PATCH Admin Metrics-registry Definitions :id

Endpoint: PATCH /admin/metrics-registry/definitions/:id Authentication: Admin (Required)

Description

PATCH /admin/metrics-registry/definitions/:id Update a metric definition

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X PATCH 'https://your-store.omnicart.cc/admin/metrics-registry/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics-registry Definitions :id

Endpoint: DELETE /admin/metrics-registry/definitions/:id Authentication: Admin (Required)

Description

DELETE /admin/metrics-registry/definitions/:id Soft delete a metric definition

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics-registry/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics-registry Definitions :id Versions

Endpoint: GET /admin/metrics-registry/definitions/:id/versions Authentication: Admin (Required)

Description

GET /admin/metrics-registry/definitions/:id/versions Get version history for a metric

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics-registry/definitions/:id/versions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Definitions :id Versions

Endpoint: POST /admin/metrics-registry/definitions/:id/versions Authentication: Admin (Required)

Description

POST /admin/metrics-registry/definitions/:id/versions/rollback Rollback to a specific version

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/definitions/:id/versions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Execute

Endpoint: POST /admin/metrics-registry/execute Authentication: Admin (Required)

Description

POST /admin/metrics-registry/execute Execute a metric formula with optional context

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/execute' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics-registry Placeholders

Endpoint: GET /admin/metrics-registry/placeholders Authentication: Admin (Required)

Description

GET /admin/metrics-registry/placeholders List all placeholders with optional filtering

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics-registry/placeholders' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Placeholders

Endpoint: POST /admin/metrics-registry/placeholders Authentication: Admin (Required)

Description

POST /admin/metrics-registry/placeholders Create a new placeholder

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/placeholders' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics-registry Validate

Endpoint: POST /admin/metrics-registry/validate Authentication: Admin (Required)

Description

POST /admin/metrics-registry/validate Validate a formula and check for circular dependencies

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics-registry/validate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Alerts

Endpoint: GET /admin/metrics/alerts Authentication: Admin (Required)

Description

GET /admin/metrics/alerts List all alerts

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/alerts' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Alerts

Endpoint: POST /admin/metrics/alerts Authentication: Admin (Required)

Description

POST /admin/metrics/alerts Create a new alert

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/alerts' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Alerts :id

Endpoint: GET /admin/metrics/alerts/:id Authentication: Admin (Required)

Description

GET /admin/metrics/alerts/:id Get a specific alert

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/alerts/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Alerts :id

Endpoint: POST /admin/metrics/alerts/:id Authentication: Admin (Required)

Description

POST /admin/metrics/alerts/:id Update an alert

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/alerts/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics Alerts :id

Endpoint: DELETE /admin/metrics/alerts/:id Authentication: Admin (Required)

Description

DELETE /admin/metrics/alerts/:id Delete an alert

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics/alerts/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Audit

Endpoint: GET /admin/metrics/audit Authentication: Admin (Required)

Description

GET /admin/metrics/audit/recent Get recent changes across all metrics

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/audit' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Audit

Endpoint: POST /admin/metrics/audit Authentication: Admin (Required)

Description

POST /admin/metrics/audit/export Export audit trail for compliance

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/audit' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Batch

Endpoint: POST /admin/metrics/batch Authentication: Admin (Required)

Description

POST /admin/metrics/batch Compute multiple metrics in parallel with intelligent caching Rate limited to 5 requests per minute per user (stricter limit for batch operations) Request body: { requests: [ { id: "dashboard-7d", type: "dashboard", filters: { range: { start: "2024-01-01", end: "2024-01-07" } }, priority: 10 }, ... ] }

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/batch' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Cache

Endpoint: POST /admin/metrics/cache Authentication: Admin (Required)

Description

POST /admin/metrics/cache/warm Warm metrics cache for common date ranges

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/cache' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics Cache

Endpoint: DELETE /admin/metrics/cache Authentication: Admin (Required)

Description

DELETE /admin/metrics/cache Invalidate all metrics cache

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics/cache' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Cache

Endpoint: GET /admin/metrics/cache Authentication: Admin (Required)

Description

GET /admin/metrics/cache/stats Get cache statistics

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/cache' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Catalog

Endpoint: GET /admin/metrics/catalog Authentication: Admin (Required)

Description

GET /admin/metrics/catalog Search metrics catalog

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/catalog' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Catalog

Endpoint: POST /admin/metrics/catalog Authentication: Admin (Required)

Description

POST /admin/metrics/catalog Register new metric

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/catalog' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Catalog :id

Endpoint: GET /admin/metrics/catalog/:id Authentication: Admin (Required)

Description

GET /admin/metrics/catalog/:id Get metric by ID

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/catalog/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

PUT Admin Metrics Catalog :id

Endpoint: PUT /admin/metrics/catalog/:id Authentication: Admin (Required)

Description

PUT /admin/metrics/catalog/:id Update metric

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X PUT 'https://your-store.omnicart.cc/admin/metrics/catalog/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics Catalog :id

Endpoint: DELETE /admin/metrics/catalog/:id Authentication: Admin (Required)

Description

DELETE /admin/metrics/catalog/:id Archive metric (soft delete)

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics/catalog/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Catalog :id Dependencies

Endpoint: GET /admin/metrics/catalog/:id/dependencies Authentication: Admin (Required)

Description

GET /admin/metrics/catalog/:id/dependencies Get metric dependency tree

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/catalog/:id/dependencies' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Catalog :id Dependents

Endpoint: GET /admin/metrics/catalog/:id/dependents Authentication: Admin (Required)

Description

GET /admin/metrics/catalog/:id/dependents Get metrics that depend on this metric

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/catalog/:id/dependents' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Catalog :id Lifecycle

Endpoint: POST /admin/metrics/catalog/:id/lifecycle Authentication: Admin (Required)

Description

POST /admin/metrics/catalog/:id/lifecycle Transition metric lifecycle state

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/catalog/:id/lifecycle' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Catalog :id Versions

Endpoint: GET /admin/metrics/catalog/:id/versions Authentication: Admin (Required)

Description

GET /admin/metrics/catalog/:id/versions Get metric version history

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/catalog/:id/versions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Catalog Seed-examples

Endpoint: POST /admin/metrics/catalog/seed-examples Authentication: Admin (Required)

Description

POST /admin/metrics/catalog/seed-examples Trigger the seed example metrics workflow This endpoint triggers a workflow that seeds 3 example metrics: - example_daily_gmv - example_orders_count - example_average_order_value The workflow is idempotent - it will skip metrics that already exist.

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/catalog/seed-examples' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Catalog Validate

Endpoint: POST /admin/metrics/catalog/validate Authentication: Admin (Required)

Description

POST /admin/metrics/catalog/validate Validate metric formula Rate limited to 10 requests per minute per user

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/catalog/validate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Compute

Endpoint: POST /admin/metrics/compute Authentication: Admin (Required)

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/compute' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Dashboard

Endpoint: GET /admin/metrics/dashboard Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/dashboard' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Definitions

Endpoint: POST /admin/metrics/definitions Authentication: Admin (Required)

Description

POST /admin/metrics/definitions Create a new metric definition

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/definitions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Definitions

Endpoint: GET /admin/metrics/definitions Authentication: Admin (Required)

Description

GET /admin/metrics/definitions List metric definitions with optional filters

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/definitions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Definitions :id

Endpoint: GET /admin/metrics/definitions/:id Authentication: Admin (Required)

Description

GET /admin/metrics/definitions/:id Get a single metric definition

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

PUT Admin Metrics Definitions :id

Endpoint: PUT /admin/metrics/definitions/:id Authentication: Admin (Required)

Description

PUT /admin/metrics/definitions/:id Update a metric definition

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X PUT 'https://your-store.omnicart.cc/admin/metrics/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics Definitions :id

Endpoint: DELETE /admin/metrics/definitions/:id Authentication: Admin (Required)

Description

DELETE /admin/metrics/definitions/:id Delete a metric definition (soft delete)

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics/definitions/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Fulfillment-report

Endpoint: POST /admin/metrics/fulfillment-report Authentication: Admin (Required)

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/fulfillment-report' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Performance

Endpoint: GET /admin/metrics/performance Authentication: Admin (Required)

Description

GET /admin/metrics/performance Get current performance metrics

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/performance' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Performance

Endpoint: POST /admin/metrics/performance Authentication: Admin (Required)

Description

POST /admin/metrics/performance/report Generate and log performance report

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/performance' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Performance Events

Endpoint: GET /admin/metrics/performance/events Authentication: Admin (Required)

Description

GET /admin/metrics/performance/events Get recent computation events

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/performance/events' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Placeholders

Endpoint: GET /admin/metrics/placeholders Authentication: Admin (Required)

Description

GET /admin/metrics/placeholders List available placeholders

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/placeholders' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Placeholders

Endpoint: POST /admin/metrics/placeholders Authentication: Admin (Required)

Description

POST /admin/metrics/placeholders Create a new placeholder

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/placeholders' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Rate-limit-status

Endpoint: GET /admin/metrics/rate-limit-status Authentication: Admin (Required)

Description

GET /admin/metrics/rate-limit-status Get rate limit metrics and monitoring data

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/rate-limit-status' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

DELETE Admin Metrics Rate-limit-status

Endpoint: DELETE /admin/metrics/rate-limit-status Authentication: Admin (Required)

Description

DELETE /admin/metrics/rate-limit-status Clear rate limit metrics (admin only)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X DELETE 'https://your-store.omnicart.cc/admin/metrics/rate-limit-status' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Report

Endpoint: POST /admin/metrics/report Authentication: Admin (Required)

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/report' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Reports

Endpoint: GET /admin/metrics/reports Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/reports' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Reports Top-products

Endpoint: GET /admin/metrics/reports/top-products Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/reports/top-products' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Suggestions

Endpoint: GET /admin/metrics/suggestions Authentication: Admin (Required)

Description

GET /admin/metrics/suggestions Get AI-powered metric suggestions

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/suggestions' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Templates

Endpoint: GET /admin/metrics/templates Authentication: Admin (Required)

Description

GET /admin/metrics/templates List all metric templates

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/templates' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Templates

Endpoint: POST /admin/metrics/templates Authentication: Admin (Required)

Description

POST /admin/metrics/templates/:id/instantiate Create a metric from a template

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/templates' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Metrics Templates :id

Endpoint: GET /admin/metrics/templates/:id Authentication: Admin (Required)

Description

GET /admin/metrics/templates/:id Get a specific template

URL Parameters

Parameter Type Required Description
id string Yes Id identifier

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/metrics/templates/:id' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

POST Admin Metrics Validate

Endpoint: POST /admin/metrics/validate Authentication: Admin (Required)

Description

POST /admin/metrics/validate Validate a metric formula Rate limited to 10 requests per minute per user

Request Body

// Request body structure (to be documented)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X POST 'https://your-store.omnicart.cc/admin/metrics/validate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Cogs Alerts

Endpoint: GET /admin/reports/cogs/alerts Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/cogs/alerts' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Cogs Inventory-turnover

Endpoint: GET /admin/reports/cogs/inventory-turnover Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/cogs/inventory-turnover' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Cogs Margins

Endpoint: GET /admin/reports/cogs/margins Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/cogs/margins' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Cogs Snapshots

Endpoint: GET /admin/reports/cogs/snapshots Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/cogs/snapshots' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Taxes Dashboard

Endpoint: GET /admin/reports/taxes/dashboard Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/taxes/dashboard' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

GET Admin Reports Taxes Export

Endpoint: GET /admin/reports/taxes/export Authentication: Admin (Required)

Response

Success:

// Response structure (to be documented)

Example Request

curl -X GET 'https://your-store.omnicart.cc/admin/reports/taxes/export' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'