Tasks

Get Task Details

GA

Retrieve detailed information about a specific Task.

Returns the complete Task configuration including:

  • Basic properties (name, description, enabled status)
  • All revisions with their prompts and configurations
  • Currently active revisions and their traffic weights
  • Associated tags and metadata

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.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

revision_tag_idstringOptionalformat: "uuid"

Filter task_revisions by tag ID.

include_testsbooleanOptional

Include test revisions

Response

Successful Response

namestringformat: "^[a-zA-Z0-9\-_ ]+$"

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.

createdstring

When the Task was created.

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.

modifiedstringOptional

When the Task was last updated.

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