---
title: "✨ Try prompt on a single task"
method: POST
path: "/api/prompts/{prompt_id}/versions/{version_id}/try-task"
tags: ["Prompts"]
---

# ✨ Try prompt on a single task

`POST /api/prompts/{prompt_id}/versions/{version_id}/try-task`

Run a single-task ephemeral prediction using the current (possibly unsaved) prompt.

No ModelRun is created and no Prediction is stored. The user iterates
until happy, then saves and does a full Run.

## Path parameters

- `prompt_id` integer, required
- `version_id` integer, required

## Request body

- TryTaskRequestRequest
  - `project_id` integer, required
  - `prompt_override` string
  - `task_id` integer, required

## Response `200`

- TryTaskResponse
  - `annotation_result` unknown[], required
    - unknown
  - `parsed_result` unknown
  - `raw_response` string, required
  - `task_id` integer, required
  - `usage` unknown, required

## Changes

> 101 revisions in range; 1 not diffed.

- **2026-07-08** `93493def8bb7` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/prompts/:prompt_id/versions/:version_id/try-task/post.md)

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/e1d2a9429168/schema)