submissions

Creates, updates, deletes, gets or lists a submissions resource.

Overview

Name	submissions
Type	Resource
Id	cloudflare.email_security.submissions

Fields

The following fields are returned by SELECT queries:

list

List of submissions

Name	Datatype	Description
escalated_submission_id	string
original_postfix_id	string	The postfix ID of the original message that was submitted
submission_id	string
customer_status	string	(escalated, reviewed, unreviewed)
escalated_as	string	(MALICIOUS, SUSPICIOUS, SPOOF, SPAM, BULK, NONE)
escalated_at	string (date-time)
escalated_by	string
original_disposition	string	(MALICIOUS, SUSPICIOUS, SPOOF, SPAM, BULK, NONE)
original_edf_hash	string
outcome	string
outcome_disposition	string	(MALICIOUS, SUSPICIOUS, SPOOF, SPAM, BULK, NONE)
requested_at	string (date-time)	When the submission was requested (UTC).
requested_by	string
requested_disposition	string	(MALICIOUS, SUSPICIOUS, SPOOF, SPAM, BULK, NONE)
requested_ts	string	Deprecated, use requested_at instead
status	string
subject	string
type	string	Whether the submission was created by a team member or an end user. (Team, User)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id	start, end, type, submission_id, original_disposition, requested_disposition, outcome_disposition, status, query, page, per_page	Returns information for submissions made to reclassify emails. Shows the status, outcome, and disposition changes for reclassification requests made by users or the security team. Useful for tracking false positive/negative reports.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
end	string (date-time)	The end of the search date range. Defaults to now.
original_disposition	string
outcome_disposition	string
page	integer	Current page within paginated list of results.
per_page	integer	The number of results per page. Maximum value is 1000.
query	string
requested_disposition	string
start	string (date-time)	The beginning of the search date range. Defaults to now - 30 days.
status	string
submission_id	string
type	string

SELECT examples

list

Returns information for submissions made to reclassify emails. Shows the status, outcome, and disposition changes for reclassification requests made by users or the security team. Useful for tracking false positive/negative reports.

SELECT
escalated_submission_id,
original_postfix_id,
submission_id,
customer_status,
escalated_as,
escalated_at,
escalated_by,
original_disposition,
original_edf_hash,
outcome,
outcome_disposition,
requested_at,
requested_by,
requested_disposition,
requested_ts,
status,
subject,
type
FROM cloudflare.email_security.submissions
WHERE account_id = '{{ account_id }}' -- required
AND start = '{{ start }}'
AND end = '{{ end }}'
AND type = '{{ type }}'
AND submission_id = '{{ submission_id }}'
AND original_disposition = '{{ original_disposition }}'
AND requested_disposition = '{{ requested_disposition }}'
AND outcome_disposition = '{{ outcome_disposition }}'
AND status = '{{ status }}'
AND query = '{{ query }}'
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
;