Get AI-prioritized restock, rebalance, and markdown recommendations ranked by urgency per product and shop

curl --request GET \
  --url https://app.solya.app/api/intelligence/decision-vectors \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "allowedActions": [
        "restock"
      ],
      "createdAt": "2025-09-15T06:00:00.000Z",
      "deficit_units": 12,
      "domain": "restock",
      "forbiddenActions": [],
      "scores": {
        "deficit_score": null,
        "overstock_risk": 0.05,
        "restock_urgency": 0.91,
        "stockout_risk": 0.85,
        "surplus_score": null,
        "transfer_urgency": null
      },
      "shopId": "shop-uuid-paris",
      "snapshotDate": "2025-09-15",
      "surplus_units": null,
      "updatedAt": "2025-09-15T06:00:00.000Z",
      "variantId": "var-uuid-001"
    },
    {
      "allowedActions": [
        "rebalance"
      ],
      "createdAt": "2025-09-15T06:00:00.000Z",
      "deficit_units": 3,
      "domain": "rebalance",
      "forbiddenActions": [],
      "scores": {
        "deficit_score": 0.2,
        "overstock_risk": null,
        "restock_urgency": null,
        "stockout_risk": null,
        "surplus_score": 0.8,
        "transfer_urgency": 0.75
      },
      "shopId": "shop-uuid-lyon",
      "snapshotDate": "2025-09-15",
      "surplus_units": 8,
      "updatedAt": "2025-09-15T06:00:00.000Z",
      "variantId": "var-uuid-002"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 1240
}

Intelligence

Get AI-prioritized restock, rebalance, and markdown recommendations ranked by urgency per product and shop

Returns a paginated list of AI-generated inventory action recommendations for each variant/shop pair. Use this endpoint to find out what to reorder, which variants need action, and which products to prioritize. Always reads the latest snapshot date for the organization. Filter by domain (restock/rebalance/markdown), variantId, or shopId. Each recommendation includes composite urgency scores and, for restock/rebalance domains, quantitative deficit_units (recommended quantity to restock — units short of target) and surplus_units (units in excess of target available for rebalancing). To act on these recommendations, use the returned variantId/shopId/domain to create an inventory plan or filter listTasks with sourceType=ACTION_VECTOR.

GET

api

intelligence

decision-vectors

Get AI-prioritized restock, rebalance, and markdown recommendations ranked by urgency per product and shop

curl --request GET \
  --url https://app.solya.app/api/intelligence/decision-vectors \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "allowedActions": [
        "restock"
      ],
      "createdAt": "2025-09-15T06:00:00.000Z",
      "deficit_units": 12,
      "domain": "restock",
      "forbiddenActions": [],
      "scores": {
        "deficit_score": null,
        "overstock_risk": 0.05,
        "restock_urgency": 0.91,
        "stockout_risk": 0.85,
        "surplus_score": null,
        "transfer_urgency": null
      },
      "shopId": "shop-uuid-paris",
      "snapshotDate": "2025-09-15",
      "surplus_units": null,
      "updatedAt": "2025-09-15T06:00:00.000Z",
      "variantId": "var-uuid-001"
    },
    {
      "allowedActions": [
        "rebalance"
      ],
      "createdAt": "2025-09-15T06:00:00.000Z",
      "deficit_units": 3,
      "domain": "rebalance",
      "forbiddenActions": [],
      "scores": {
        "deficit_score": 0.2,
        "overstock_risk": null,
        "restock_urgency": null,
        "stockout_risk": null,
        "surplus_score": 0.8,
        "transfer_urgency": 0.75
      },
      "shopId": "shop-uuid-lyon",
      "snapshotDate": "2025-09-15",
      "surplus_units": 8,
      "updatedAt": "2025-09-15T06:00:00.000Z",
      "variantId": "var-uuid-002"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 1240
}

Authorizations

Authorization

string

header

required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Query Parameters

page

integer

default:1

Page number, 1-indexed (default: 1)

Required range: 1 <= x <= 9007199254740991

pageSize

integer

default:20

Number of items per page, max 100 (default: 20)

Required range: 1 <= x <= 100

variantId

string

Filter by variant ID

shopId

string

Filter by shop ID

domain

enum<string>

Filter by decision domain: restock, rebalance, or markdown

Available options:

restock,

rebalance,

markdown

Response

Successful response

data

object

required

Show child attributes

success

enum<boolean>

required

Available options:

true

Retrieve the full body of a skill by ID List outcome attributions