POST /accounts/{account_id}/data-security/posture/findings/{storage_namespace_id}/instances/export

Creates a CSV export for Finding instances and accepts optional filters in the payload.

The storage_namespace_id path parameter is derived from the finding ID by base64-decoding it (which yields integration_id:finding_type_id) and replacing the colon with a hyphen.

Servers

Path parameters

Name Type Required Description
account_id String Yes

Cloudflare account ID for the user making the request.

storage_namespace_id String Yes

A storage namespace identifier for the finding, used to scope finding instance exports. Constructed by base64-decoding the finding ID (which encodes integration_id:finding_type_id) and replacing the colon separator with a hyphen. For example, a finding ID that decodes to 00000000-0000-0000-0000-000000000001:00000000-0000-0000-0000-000000000002 becomes 00000000-0000-0000-0000-000000000001-00000000-0000-0000-0000-000000000002.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
min_affliction_date String No

Filter to view findings that occurred on or after the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp.

max_affliction_date String No

Filter to view findings that occurred on or before the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp.

archived Boolean No

Filter for archived status.

orders[] Array No

Ordering specifications for the export.

orders[].name String Yes

Which field to use when ordering the finding instances.

Valid values:

  • "asset.name"
  • "affliction_date"
orders[].direction String Yes

Sort direction.

Valid values:

  • "desc"
  • "asc"
search String No

A search term.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.