Get Task Details

GA
GET

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.

Query parameters

revision_tag_idstringOptionalformat: "uuid"

Filter task_revisions by tag ID.

include_testsbooleanOptional

Include test revisions

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