Skip to content
autom8y

Update a task

PUT
/api/v1/tasks/{gid}

Update an existing task.

Only provided fields are updated; omitted fields retain their values.

Args: gid: Asana task GID. body: Fields to update.

Returns: Updated task data.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
gid
required
Gid
string

Request Body required

Section titled “Request Body required ”
UpdateTaskRequest

Request body for updating a task.

Per FR-API-TASK-004: Update task endpoint.

All fields are optional; only provided fields are updated.

Attributes: name: New task name. notes: New task description. completed: Task completion status. due_on: Due date in YYYY-MM-DD format (null to clear).

object
name
Any of:
string
>= 1 characters
notes
Any of:
string
completed
Any of:
boolean
due_on
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

SuccessResponse[AsanaResource]
object
data
required
AsanaResource

Response data payload

object
gid
required
Gid

Globally unique Asana resource identifier

string
resource_type
Any of:
string
name
Any of:
string
key
additional properties
any
meta
required
ResponseMeta

Response metadata

object
request_id
required
Request Id

Request correlation ID

string
>= 1 characters
timestamp
Timestamp

Response timestamp (UTC)

string format: date-time
pagination
Any of:
PaginationMeta

Pagination metadata for list responses.

Per ADR-ASANA-008: Cursor-based pagination with opaque offset.

Attributes: limit: Number of items requested per page. has_more: Whether more items exist after this page. next_offset: Opaque cursor for next page (None if no more pages).

object
limit
required
Limit

Number of items per page

integer
>= 1
has_more
required
Has More

Whether more items exist

boolean
next_offset
Any of:
string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string