Skip to main content
GET
/
api
/
business-knowledge
List business knowledge entries for the authenticated organization
curl --request GET \
  --url https://app.solya.app/api/business-knowledge \
  --header 'Authorization: Bearer <token>'
{
  "guidance": [
    {
      "actionFamilies": [
        "MARKDOWN_PLAN"
      ],
      "body": "Les démarques sont appliquées par vague : -20% à J+30 après entrée en stock, -40% à J+60, puis arbitrage manuel au-delà.",
      "createdAt": "2026-01-10T09:00:00.000Z",
      "id": "bk-guidance-politique-soldes",
      "isActive": true,
      "scope": null,
      "source": "ORG",
      "tags": [
        "markdown",
        "soldes",
        "pricing"
      ],
      "title": "Politique de soldes et démarques",
      "updatedAt": null
    },
    {
      "actionFamilies": [
        "RESTOCK_PLAN"
      ],
      "body": "Les boutiques flagship bénéficient d'un coefficient de priorité x1.5 lors des allocations en cas de tension stock.",
      "createdAt": "2026-01-15T11:00:00.000Z",
      "id": "bk-guidance-priority-boutiques",
      "isActive": true,
      "scope": null,
      "source": "ORG",
      "tags": [
        "restock",
        "allocation",
        "boutiques"
      ],
      "title": "Priorité de réassort par type de boutique",
      "updatedAt": null
    }
  ],
  "skills": [
    {
      "id": "bk-skill-process-reassort",
      "title": "Processus de réassort Polaris",
      "whenToUse": "Utilise ce skill quand l'utilisateur demande à réassortir une boutique ou à créer un plan de réassort."
    },
    {
      "id": "bk-skill-rebalancing-region",
      "title": "Rééquilibrage inter-boutiques région",
      "whenToUse": "Utilise ce skill quand l'utilisateur souhaite rééquilibrer le stock entre boutiques ou créer un transfert inter-boutiques."
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Query Parameters

actionFamily
enum<string>

Filter by action family. Entries with an empty actionFamilies list (transversal) always match. Allowed values: RESTOCK_PLAN, REBALANCE_PLAN, MARKDOWN_PLAN, PRE_SEASON_PLAN, RECOMMENDATION, WORKFLOW, SUPPLIER_RETURN_PLAN, SUPPLIER_EXCHANGE_PLAN

Available options:
RESTOCK_PLAN,
REBALANCE_PLAN,
MARKDOWN_PLAN,
PRE_SEASON_PLAN,
RECOMMENDATION,
WORKFLOW,
SUPPLIER_RETURN_PLAN,
SUPPLIER_EXCHANGE_PLAN
tags

Filter by tags. Accepts multiple values (?tags=restock&tags=pricing). Entries with an empty tags list (transversal) always match. Optional.

Response

Successful response

data
object
required
success
enum<boolean>
required
Available options:
true