Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qalico.com/llms.txt

Use this file to discover all available pages before exploring further.

Subscriptions

Subscriptions control which regulatory sources and references a workspace monitors. Updates and references are filtered based on subscription status. Subscriptions work at two levels:
  • Source level — subscribe to an entire regulatory body (e.g. FDA Guidances)
  • Reference level — override for individual documents (e.g. unsubscribe from a specific guidance even if the source is subscribed, or subscribe to a specific standard even if the source is not)

Get subscriptions

GET /api/workspaces/:workspaceId/subscriptions
Returns all sources with their subscription status, plus any reference-level overrides. Response:
{
  "sources": [
    {
      "sourceId": "fda_guidance",
      "sourceTitle": "FDA Guidances",
      "geography": "us",
      "status": "subscribed"
    },
    {
      "sourceId": "mdcg",
      "sourceTitle": "MDCG Guidelines",
      "geography": "eu",
      "status": "unsubscribed"
    }
  ],
  "references": [
    {
      "referenceId": "ref-uuid",
      "referenceTitle": "MDCG 2021-24",
      "referenceExternalId": "mdcg-2021-24",
      "sourceId": "mdcg",
      "status": "subscribed"
    }
  ]
}
Sources with no subscription record are returned as "unsubscribed".

Update subscriptions

PATCH /api/workspaces/:workspaceId/subscriptions
Update source and/or reference subscriptions. Both fields are optional.
sources
object[]
Source-level subscription changes. Each object has sourceId and status ("subscribed" or "unsubscribed").
references
object[]
Reference-level subscription overrides. Each object has referenceId and status ("subscribed" or "unsubscribed").
{
  "sources": [
    { "sourceId": "fda_guidance", "status": "subscribed" },
    { "sourceId": "ansm", "status": "unsubscribed" }
  ],
  "references": [
    { "referenceId": "ref-uuid", "status": "subscribed" }
  ]
}
Response:
{ "updated": 3 }
After updating, an impact assessment job is triggered in the background to generate AI impact summaries for newly subscribed updates.

Generate subscriptions with AI

POST /api/workspaces/:workspaceId/subscriptions/generate
AI reads the workspace profile and recommends source and reference subscriptions based on the company’s products, markets, and risk classifications. Requires a profile to exist first (create one via the profile endpoints). Returns immediately — the AI tasks and impact assessment run in the background. Response:
{ "success": true }