# assistant-facts

> Structured facts with expiry, season rollover and assistant routing.

Structured facts with expiry, season rollover and assistant routing.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/ai-assistants/{assistant_id}/facts` | `facts_list`: List facts (status active / expiring / expired) | `ai:read` | - |
| POST | `/v1/ai-assistants/{assistant_id}/facts` | `facts_create`: Create a fact (needs an expiry or review date) | `ai:write` | - |
| POST | `/v1/ai-assistants/{assistant_id}/facts:import` | `facts_import`: Bulk import facts (CSV: kind,key,label,value,currency,valid_from,expires_at) | `ai:write` | - |
| GET | `/v1/ai-assistants/{assistant_id}/facts/expiring` | `facts_list_stale`: Facts expiring within N days (or expired) | `ai:read` | - |
| POST | `/v1/ai-assistants/{assistant_id}/season-rollover` | `facts_start_season_rollover`: Start the season rollover (copies facts as DRAFT) | `ai:write` | - |
| POST | `/v1/ai-assistants/{assistant_id}/season-rollover/{rollover_id}/confirm` | `facts_apply_season_rollover`: Confirm facts of a rollover (activate new, archive old) | `ai:write` | - |
| DELETE | `/v1/ai-facts/{fact_id}` | `facts_delete`: Delete a fact (archived; stage history keeps it) | `ai:write` | - |
| GET | `/v1/ai-facts/{fact_id}` | `facts_get`: Get one fact | `ai:read` | - |
| PATCH | `/v1/ai-facts/{fact_id}` | `facts_update`: Edit a fact | `ai:write` | - |
| GET | `/v1/workspaces/{workspace_id}/assistant-routing` | `ai_assistant_routing_get`: Assistant routing rules | `ai:read` | - |
| PUT | `/v1/workspaces/{workspace_id}/assistant-routing` | `ai_assistant_set_routing`: Set assistant routing (first match wins) | `ai:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
