Skip to content
Cloudflare API
Start here
API Reference
Zero Trust
Casb
Posture
Remediations
Jobs

List remediation jobs

client.zeroTrust.casb.posture.remediations.jobs.list(JobListParams { account_id, cursor, direction, 9 more } params, RequestOptionsoptions?): V4PagePaginationArray<JobListResponse { id, asset, created_at, 11 more } >
GET/accounts/{account_id}/data-security/posture/remediations/jobs

List all remediation jobs tied to a specific Cloudflare Account. Note that cursor and page are mutually exclusive.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
Accepted Permissions (at least one required)
Zero Trust ReadZero Trust Write
ParametersExpand Collapse
params: JobListParams { account_id, cursor, direction, 9 more }
account_id: string

Path param: Cloudflare account ID for the user making the request.

cursor?: string

Query param: A cursor for pagination.

direction?: "asc" | "desc"

Query param: Direction to order results.

One of the following:
"asc"
"desc"
integration_id?: string

Query param: Filter by an integration ID

formatuuid
max_updated_at?: string

Query param: Filter to view remediations updated on or before the max updated datetime. Can be a date-time in ISO 8601 format or an epoch timestamp.

formatdate-time
min_updated_at?: string

Query param: Filter to view remediations updated on or after the min updated datetime. Can be a date-time in ISO 8601 format or an epoch timestamp.

formatdate-time
order?: "created_at" | "affliction_date" | "integration_name" | 4 more

Query param: An optional param to sort the results by the given field.

One of the following:
"created_at"
"affliction_date"
"integration_name"
"status"
"last_updated_at"
"asset_name"
"finding_type_name"
page?: number

Query param: A page number within the paginated result set.

per_page?: number

Query param: Number of results to return per page.

status?: "pending" | "processing" | "completed" | 2 more

Query param: Filter to view remediations with the given status.

One of the following:
"pending"
"processing"
"completed"
"failed"
"validating"
triggered_by_actor?: Array<"user" | "account_token">

Query param: Filter remediations by what kind of actor triggered them. Supports multiple comma-separated values.

One of the following:
"user"
"account_token"
ReturnsExpand Collapse
JobListResponse { id, asset, created_at, 11 more }

Information about a remediation job.

id: string

Unique identifier for the remediation job.

formatuuid
asset: Asset { id, category, external_id, 3 more }

Asset information for a remediation job.

id: string

Unique identifier for the asset.

formatuuid
category: Category { service, type, vendor }

Category information for a remediation job asset.

service: string

Specific service within the vendor.

type: string

Asset type.

vendor: "AWS" | "Anthropic" | "Bitbucket" | 16 more

Display names for vendor types.

One of the following:
"AWS"
"Anthropic"
"Bitbucket"
"Box"
"Confluence"
"Dropbox"
"GitHub"
"Google Cloud Platform"
"Google Workspace"
"Jira"
"Microsoft"
"Microsoft Internal"
"Okta"
"OpenAI"
"Slack"
"Salesforce"
"ServiceNow"
"Workday"
"Zoom"
external_id: string

External identifier from the source system.

fields: Array<Field>

Additional fields associated with the asset.

name: string

Field name.

value: string | number | boolean

Field value (can be string, number, or boolean).

One of the following:
string
number
boolean
name: string

Human-readable name of the asset.

created_at: string

When the remediation job was created.

formatdate-time
finding_id: string

Encoded finding ID.

finding_instance_id: string

ID of the finding instance being remediated.

formatuuid
finding_type_id: string

ID of the finding type.

formatuuid
finding_type_name: string

Name of the finding type.

integration_name: string

Name of the integration.

last_updated: string

When the remediation job was last updated.

formatdate-time
remediation_type: string

Type of remediation being performed.

status: "pending" | "processing" | "completed" | 2 more

Status of a remediation job.

One of the following:
"pending"
"processing"
"completed"
"failed"
"validating"
triggered_by_user: string

Email of the user who triggered the remediation. For account-token actors this is the literal “Account API Token”; for policy actors this is empty.

triggered_by_actor?: "user" | "account_token" | null

Type of actor that triggered the remediation job. Null on legacy rows created before this column was populated.

One of the following:
"user"
"account_token"
triggered_by_id?: string | null

ID of the actor that triggered the job. Meaning depends on triggered_by_actor. Null on legacy rows.

List remediation jobs

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const jobListResponse of client.zeroTrust.casb.posture.remediations.jobs.list({
  account_id: '46148281d8a93d002ef242d8b0d5f9f6',
})) {
  console.log(jobListResponse.id);
}
{
  "errors": [
    {}
  ],
  "messages": [
    {}
  ],
  "result": [
    {
      "id": "c416bc38-75db-425f-ae25-c37b5df5c37f",
      "asset": {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "category": {
          "service": "OneDrive",
          "type": "SaaS",
          "vendor": "Google Workspace"
        },
        "external_id": "c416bc38-75db-425f-ae25-c37b5df5c37f",
        "fields": [
          {
            "name": "File Name",
            "value": "sensitive-document.xlsx",
            "link": "https://dashboard.microsoft.com/files/details"
          }
        ],
        "name": "Microsoft File Publicly Accessible",
        "link": "https://dashboard.microsoft.com/files/details"
      },
      "created_at": "2025-07-07T18:39:13.123456Z",
      "finding_id": "MDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAxOjAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwLTAwMDAwMDAwMDAwMgo=",
      "finding_instance_id": "3f7b8c9d-6e5a-4f3b-9c2d-1e0a8b7c6d5e",
      "finding_type_id": "775c5f38-efcf-4b2b-93db-8428979eb6a2",
      "finding_type_name": "Microsoft: File publicly accessible with edit access",
      "integration_name": "Microsoft",
      "last_updated": "2025-07-07T18:39:13.123456Z",
      "remediation_type": "Remove publicly accessible edit url",
      "status": "pending",
      "triggered_by_user": "user@example.com",
      "triggered_by_actor": "user",
      "triggered_by_id": "0123456789abcdef0123456789abcdef"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "next_cursor_value",
    "page": 1,
    "per_page": 10,
    "total_count": 2
  },
  "success": true
}
Returns Examples
{
  "errors": [
    {}
  ],
  "messages": [
    {}
  ],
  "result": [
    {
      "id": "c416bc38-75db-425f-ae25-c37b5df5c37f",
      "asset": {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "category": {
          "service": "OneDrive",
          "type": "SaaS",
          "vendor": "Google Workspace"
        },
        "external_id": "c416bc38-75db-425f-ae25-c37b5df5c37f",
        "fields": [
          {
            "name": "File Name",
            "value": "sensitive-document.xlsx",
            "link": "https://dashboard.microsoft.com/files/details"
          }
        ],
        "name": "Microsoft File Publicly Accessible",
        "link": "https://dashboard.microsoft.com/files/details"
      },
      "created_at": "2025-07-07T18:39:13.123456Z",
      "finding_id": "MDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAxOjAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwLTAwMDAwMDAwMDAwMgo=",
      "finding_instance_id": "3f7b8c9d-6e5a-4f3b-9c2d-1e0a8b7c6d5e",
      "finding_type_id": "775c5f38-efcf-4b2b-93db-8428979eb6a2",
      "finding_type_name": "Microsoft: File publicly accessible with edit access",
      "integration_name": "Microsoft",
      "last_updated": "2025-07-07T18:39:13.123456Z",
      "remediation_type": "Remove publicly accessible edit url",
      "status": "pending",
      "triggered_by_user": "user@example.com",
      "triggered_by_actor": "user",
      "triggered_by_id": "0123456789abcdef0123456789abcdef"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "next_cursor_value",
    "page": 1,
    "per_page": 10,
    "total_count": 2
  },
  "success": true
}