Update a Task

GA
POST

Update an existing Task with new configuration or create a new revision.

When updating a Task, you can:

  1. Modify basic Task properties (name, description, enabled status)
  2. Create a new revision with updated prompts and configuration
  3. Manage active revisions and their traffic weights
  4. Update tags for the Task or specific revisions

Note: Creating a new revision does not automatically make it active. Use the active_revisions field to control which revisions receive traffic.

Path parameters

org_idstringRequired

The unique identifier of the organization.

project_idstringRequired

The unique identifier of the project.

task_idstringRequired

The specific Task to reference.

Request

This endpoint expects an object.
system_promptstringOptional

The system prompt that is used to set the LLM context.

user_promptstringOptional

The description of the Task. It is not required to mention the outputs in the prompt, but it can help the model to understand the context better. Any input strings should be referenced with the dynamic {...} syntax, this informs the model to look for those values in the input data.

llm_model_idstringOptionalformat: "uuid"

The LLM model to use for the Task.

llm_configobjectOptional

Specific configuration parameters for the LLM model.

output_formatmap from strings to optional objects or "str" or "string" or "boolean" or "bool" or "int" or "integer" or "list"Optional

This gives control over the structure of how the Task responds. Supports shorthand notation or an object with type can be specified for each attribute. In most instances, the LLM will be able to generate the desired output into the relevant property, but an optional description can be passed to provide it with additional context.

task_forwarder_idstringOptionalformat: "uuid"

The unique identifier for a valid Task Forwarder. It is used to forward the Task output to another system or service.

ragobjectOptional

Note: This is a Paid Tier feature. Provide additional domain specific input to the LLM so that it is able to reference user specific information when executing the Task. Examples of this could be a product catalogue, terms and conditions or a user manual.

image_requiredbooleanOptional

When true it requires an image to be sent in the Task Run request.

annotationstringOptional<=255 characters
testbooleanOptionalDefaults to false

True if revision is a test revision. Test revisions cannot be live and are used for rapid Task testing/iteration.

input_processorslist of objectsOptional
optimise_imagesbooleanOptional

When true (default) images will be automatically optimised before processing. Set to false to disable lossy image optimisation.

namestringOptional

A name or reference for the Task.

descriptionstringOptional

A longer description of the Task for internal reference.

enabledbooleanOptional

When true the Task is active and callable. false denotes the Task is not yet operational.

active_revisionslist of objectsOptional

The revision currently active for this Task.

tagslist of stringsOptional
revision_tagslist of stringsOptional

Response

Successful Response

namestring

A name or reference for the Task.

enabledboolean

When true the Task is active and callable. false denotes the Task is not yet operational.

idstringformat: "uuid"

The unique identifier of the Task.

project_idstringformat: "uuid"

The Project that the Task belongs to.

createddatetime

When the Task was created.

modifieddatetime

When the Task was last updated.

active_revisionslist of objects

The revision currently active for this Task.

descriptionstringOptional

A longer description of the Task for internal reference.

publicbooleanOptionalDefaults to false

When true the Task is public and can be accessed by any User.

revisionslist of objectsOptional

Each update to a Task results in a new Revision being created. Task Revisions are a powerful concept that can be used to assist with A/B testing, comparing responses from different LLM’s, etc.

access_tokenstringOptional

Task specific Bearer token that can be used to authenticated when executing this Task.

tagslist of objectsOptional

Errors

Built with