GET /v1/organizations/{org_id}/projects/{id}/cases

The handling track (“cases”) of a project’s CVEs: triage status and change history. Returns only your cases on the project.

Note

Paid feature (cases). On a plan that does not include it, the endpoint returns 403.

List cases

GET /api/v1/organizations/{org_id}/projects/{project_id}/cases
Authorization: Bearer twa_your_key_here

Path Parameters

Parameter	Type	Description
org_id	UUID	Organization identifier
project_id	UUID	Project identifier

Query Parameters

Parameter	Type	Description
status	string	Filter: PENDING, ANALYZING, FIXING, ACCEPTED, RESOLVED, NOT_APPLICABLE

Response 200 OK

[
  {
    "cve_id": "CVE-2024-3094",
    "status": "FIXING",
    "severity": "CRITICAL",
    "notes": "Patch rollout in progress",
    "created_at": "2024-06-20T09:00:00Z",
    "updated_at": "2024-07-01T14:10:00Z",
    "tags": [
      { "id": "018ec0de-0000-7000-8000-0000000000a2", "name": "to-patch", "color": "#f59e0b" }
    ]
  }
]

Fields

Field	Type	Description
cve_id	string	Related CVE
status	string	Handling status (see filter above)
severity	string | null	CVE severity
notes	string | null	Internal notes
created_at	string (ISO 8601)	Case creation date
updated_at	string (ISO 8601)	Last update
tags	array<Tag>	Team tags assigned to this CVE in the project. Each tag: { id, name, color } (color #rrggbb). Empty array if none.

Case details

GET /api/v1/organizations/{org_id}/projects/{project_id}/cases/{cve_id}
Authorization: Bearer twa_your_key_here

Adds the history field (status changes, oldest to newest):

{
  "cve_id": "CVE-2024-3094",
  "status": "FIXING",
  "history": [
    { "from_status": null, "to_status": "PENDING", "comment": null, "created_at": "2024-06-20T09:00:00Z" },
    { "from_status": "PENDING", "to_status": "FIXING", "comment": "Patch identified", "created_at": "2024-06-25T11:30:00Z" }
  ]
}

Errors

Code	Detail	Cause
403	La fonctionnalité « cases » n'est pas incluse dans le plan ...	Plan without the cases feature
404	Projet introuvable	Project not found or not in this organization
404	Cas introuvable	No case for this CVE on this project

Example

Unresolved cases of the project

ORG_ID="018e5678-abcd-7000-8000-000000000001"
PROJECT_ID="018e1234-abcd-7000-8000-000000000010"

curl -s \
  -H "Authorization: Bearer twa_your_key_here" \
  "https://app.techwatchalert.com/api/v1/organizations/${ORG_ID}/projects/${PROJECT_ID}/cases" \
  | jq '.[] | select(.status != "RESOLVED" and .status != "NOT_APPLICABLE") | {cve_id, status, severity}'