CreateTask

Create a new Task.

CreateTaskRequest

Request
This endpoint expects an object.
display_namestring

Human-readable display name for this Task, should be short (<100 chars).

specificationobject
Full task parameterization.
authorobject
Who or what is creating this Task. For example, if a user created this Task via a UI, it would contain the "user" Principal type with the user ID of that user. Or if a service is calling the CreateTask endpoint, then a "service" Principal type is to be provided.
relationsobject
Any relationships associated with this Task, such as a parent Task or an assignee this Task is designated to for execution.
descriptionstring

Longer, free-form, human-readable description of this Task.

is_executed_elsewhereboolean

If set, then task-manager will not trigger execution of this task on an agent. Useful for when ingesting tasks from an external system that is triggering execution of tasks on agents.

task_idstring

If non-empty, will set the requested Task ID, otherwise will generate a new random GUID. Will reject if supplied Task ID does not match [A-Za-z0-9_-.]{5,36}.

initial_entitieslist of objects
Indicates an initial set of entities that can be used to execute an entity aware task. For example, an entity Objective, an entity Keep In Zone, etc.

CreateTaskResponse

Response
This endpoint returns an object.
taskobject
Task that was created.