> ## 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.

# Updates

> List and inspect regulatory changes

# Updates

Updates are change events — new publications, revisions, withdrawals, and status changes to regulatory documents. Only updates for subscribed sources/references are returned.

## List updates

```bash theme={null}
GET /api/workspaces/:workspaceId/updates
```

<ParamField query="status" type="string">
  Comma-separated applicability statuses: `to_review`, `applicable`, `not_applicable`, `out_of_scope`
</ParamField>

<ParamField query="priority" type="string">
  Comma-separated priorities: `urgent`, `high`, `medium`, `low`, `none`
</ParamField>

<ParamField query="search" type="string">
  Search in title, summary, and reference title
</ParamField>

<ParamField query="source" type="string">
  Comma-separated source IDs
</ParamField>

<ParamField query="geography" type="string">
  Comma-separated geography codes
</ParamField>

<ParamField query="publicationDateFrom" type="string">
  ISO 8601 date (e.g. `2026-01-01`)
</ParamField>

<ParamField query="publicationDateTo" type="string">
  ISO 8601 date
</ParamField>

**Response:**

```json theme={null}
[
  {
    "id": "update-uuid",
    "kind": "regulatory_update",
    "reference": {
      "id": "ref-uuid",
      "externalId": "mdcg-2021-24",
      "title": "MDCG 2021-24 — Guidance on classification",
      "type": "guidance",
      "source": {
        "id": "mdcg",
        "title": "MDCG Guidelines",
        "geography": "eu",
        "institutionName": "MDCG"
      }
    },
    "update": {
      "updateType": "revision",
      "title": "MDCG 2021-24 rev.1",
      "shortSummary": "Updated classification examples for AI/ML devices",
      "summary": "This revision adds...",
      "publicationDate": "2026-04-10T00:00:00.000Z"
    },
    "context": {
      "status": "applicable",
      "priority": "high",
      "impactSummary": "Directly affects classification of your AI-powered diagnostic device...",
      "suggestedActions": "Review updated examples in Annex B..."
    }
  }
]
```

<Note>
  `context` is `null` for updates that haven't been through impact assessment yet. After subscriptions are set, an impact assessment runs in the background — this typically takes a few minutes.
</Note>

## Get update detail

```bash theme={null}
GET /api/workspaces/:workspaceId/updates/:updateId
```

Returns the full update with content, redline, and version references.

**Response:**

```json theme={null}
{
  "id": "update-uuid",
  "kind": "regulatory_update",
  "reference": {
    "id": "ref-uuid",
    "externalId": "mdcg-2021-24",
    "title": "MDCG 2021-24 — Guidance on classification",
    "type": "guidance",
    "source": {
      "id": "mdcg",
      "title": "MDCG Guidelines",
      "geography": "eu",
      "institutionName": "MDCG"
    }
  },
  "update": {
    "updateType": "revision",
    "title": "MDCG 2021-24 rev.1",
    "shortSummary": "Updated classification examples",
    "summary": "Full AI-generated summary...",
    "content": "# Section 1\n\nThe revised text...",
    "publicationDate": "2026-04-10T00:00:00.000Z",
    "sharedFile": {
      "id": "file-uuid",
      "name": "mdcg-2021-24-rev1.pdf",
      "signedUrl": "https://s3.amazonaws.com/..."
    }
  },
  "context": {
    "status": "applicable",
    "priority": "high",
    "impactSummary": "Directly affects classification...",
    "suggestedActions": "Review updated examples..."
  },
  "currentVersion": {
    "id": "version-uuid",
    "referenceId": "ref-uuid"
  },
  "previousVersion": {
    "id": "prev-version-uuid",
    "referenceId": "ref-uuid"
  },
  "redline": {
    "html": "<div class='redline'>...<ins>added text</ins>...<del>removed text</del>...</div>",
    "status": "completed"
  }
}
```

| Field               | Description                                                                                                |
| ------------------- | ---------------------------------------------------------------------------------------------------------- |
| `update.content`    | Markdown content of the update, if available                                                               |
| `update.sharedFile` | Signed URL for the update's PDF, if available                                                              |
| `currentVersion`    | The version this update created/modified                                                                   |
| `previousVersion`   | The prior version, for comparison                                                                          |
| `redline`           | HTML diff between current and previous version. `status` is `none`, `generating`, `completed`, or `failed` |