Sign in
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

Changes

Changed in 2 of the 66 revisions of this API.2

  • 51fa3598de151See the full diff
    • ●

      changed the pattern of the header request parameter Prefer from ^wait=[0-9]+$ to ^wait=(-1|[0-9]+)$

      request-parameter-pattern-changed

  • a426ff0abf8f1See the full diff
    • ●

      changed the pattern of the header request parameter Prefer from ^wait=(-1|[0-9]+)$ to ^wait=[0-9]+$

      request-parameter-pattern-changed

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog