List Threat Signals articles
Lists articles from the account’s Threat Signals feeds.
Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
Accepted Permissions (at least one required)
Query Parameters
Repeatable article UUID filter. Returns the union of matching account-owned articles; use this to list every Threat Signals article referenced by an indicator’s sources.
Opaque cursor from a previous response’s next_cursor. When provided, pagination, ordering, totals, and article filters come from the cursor. Sending per_page, sort, include_total, or any article filter alongside it returns a 400 CursorFilterConflictError.
Exact feed-category filter after trimming. Omit to include every category.
Feed UUID filter. Omit to include articles from every account feed.
Include articles fetched at or after this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.
Include articles fetched at or before this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.
When true on the first page, count matching articles and return an exact total. Defaults to false; cursor pages do not recalculate totals.
Number of articles per cursor page, from 1 to 100. Defaults to 20.
Beta. Active Priority Intelligence Requirement to report, filter, and sort relevance by. Omit to use each article’s most relevant active PIR. Returns a 400 error unless the PIR is active.
Include articles published at or after this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.
Include articles published at or before this ISO 8601 date-time with Z or a numeric UTC offset; normalized to UTC.
Filter by read state. Accepts true, false, 1, or 0; omit to include read and unread articles.
NFC-normalized, trimmed literal substring filter on article titles; ASCII case-insensitive, from 1 to 500 characters.
Sort by fetched_at, published_at, title, or relevance (beta). Prefix the field with - for descending order; defaults to -fetched_at. -relevance lists the most relevant articles first, by pir_id or by each article’s most relevant active PIR, with unscored articles last.
Legacy human-readable tag-value filter. Ignored when tag_id is supplied; prefer tag_id.
Legacy category-name disambiguator for tag. It has no effect without tag; prefer tag_category_id.
List Threat Signals articles
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cloudforce-one/v2/threat-signals/articles \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"errors": [
{
"message": "message"
}
],
"result": {
"articles": [
{
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"dataset_id": "dataset_id",
"event_id": "event_id",
"feed_display_name": "feed_display_name",
"feed_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"fetched_at": "fetched_at",
"link": "link",
"published_at": "published_at",
"read": true,
"read_at": "read_at",
"relevance": {
"band": "low",
"pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"pirs": [
{
"band": "low",
"pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}
]
},
"severity": "informational",
"summary": "summary",
"tags": [
{
"applied_by": "ai",
"categoryId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"value": "value"
}
],
"title": "title"
}
],
"has_more": true,
"next_cursor": "next_cursor",
"total_count": 0,
"total_count_is_exact": true
},
"success": true
}Returns Examples
{
"errors": [
{
"message": "message"
}
],
"result": {
"articles": [
{
"id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"dataset_id": "dataset_id",
"event_id": "event_id",
"feed_display_name": "feed_display_name",
"feed_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"fetched_at": "fetched_at",
"link": "link",
"published_at": "published_at",
"read": true,
"read_at": "read_at",
"relevance": {
"band": "low",
"pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"pirs": [
{
"band": "low",
"pir_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}
]
},
"severity": "informational",
"summary": "summary",
"tags": [
{
"applied_by": "ai",
"categoryId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"value": "value"
}
],
"title": "title"
}
],
"has_more": true,
"next_cursor": "next_cursor",
"total_count": 0,
"total_count_is_exact": true
},
"success": true
}