Sign in

v51

OpenAPI 3.0.3Apache-2.0raw.githubusercontent.com2026-08-01276140748.5 KB
Clients
Enterprise

Creates a scheduled task

Deprecated: This endpoint will no longer be supported in future releases. Please use POST /api/v2/clients/{client_id}/jobs instead.

post/api/v2/clients/{client_id}/tasks

Headers

Preferstring

Prefer header, used to specify a custom timeout in seconds using the wait parameter as per RFC7240. Passing in wait=-1 bypasses all timeout limits when the feature is enabled.

Request body

idinteger

This is the unique identifier for this object.

created_atstring date-time
updated_atstring date-time
client_idstring uuid
client_namestring
status-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

This enum describes the current status of a Job. Values are:

  • -1 Invalid
  • 0 Ready
  • 1 Running
  • 2 Complete
  • 3 Canceled
  • 4 Timed Out
  • 5 Failed
  • 6 Ingesting
  • 7 Analyzing
  • 8 Partially Complete
statusMessagestring
start_timestring date-time
end_timestring date-time
session_collectionboolean
local_group_collectionboolean
ad_structure_collectionboolean
cert_services_collectionboolean
ca_registry_collectionboolean
dc_registry_collectionboolean
all_trusted_domainsboolean
event_titlestring
last_ingeststring date-time
ousstring[]
domainsstring[]

Response

OK