Skip to main content
PATCH
/
api
/
v1
/
tasks
/
{task_id}
Update Draft Task
curl --request PATCH \
  --url https://api.example.com/api/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "category": "<string>",
  "task_type": "<string>",
  "requirements": {},
  "budget_usd": 151.5,
  "experimentation": 0.5,
  "brand_kit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "title": "<string>",
  "description": "<string>",
  "category": "<string>",
  "task_type": "<string>",
  "requirements": {},
  "budget_usd": 123,
  "compute_budget": 123,
  "status": "<string>",
  "experimentation": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "attachments": [
    "<string>"
  ],
  "brand_kit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "prototype_tier": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.aitasker.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_id
string<uuid>
required

Body

application/json

Partial update for a draft task. All fields optional.

Note on description: NO min_length constraint here. Drafts are incomplete-by-design — the autosave fires on every keystroke, so requiring DESCRIPTION_MIN_LENGTH chars mid-typing would reject every interim save. The DESCRIPTION_MIN_LENGTH-char content requirement (typed OR transcript) is enforced at PUBLISH time by publish_draft_task in api/routes/tasks.py — the same rule TaskCreate's _require_content_or_synthesize_from_transcript enforces.

​
title
string | null
Maximum string length: 200
​
description
string | null
Maximum string length: 5000
​
category
string | null
​
task_type
string | null
​
requirements
Requirements · object
​
budget_usd
number | null
Required range: 3 <= x <= 300
​
experimentation
number | null
Required range: 0 <= x <= 1
​
brand_kit_id
string<uuid> | null

Response

Successful Response

​
id
string<uuid>
required
​
user_id
string<uuid>
required
​
title
string
required
​
description
string
required
​
category
string
required
​
task_type
string
required
​
requirements
Requirements · object
required
​
budget_usd
number
required
​
compute_budget
number | null
required
​
status
string
required
​
experimentation
number
required
​
created_at
string<date-time>
required
​
expires_at
string<date-time>
required
​
attachments
string[] | null
​
brand_kit_id
string<uuid> | null
​
prototype_tier
integer | null