Sample - Asana API
PUT/sections/{section_gid}

Update a section

Updates an existing section and returns its complete updated record. Send the name field in the data block; insert_before and insert_after control placement and cannot be supplied together.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated list of response properties to include, such as `name`, `project.name`, or `projects.resource_subtype`; omit it to use the default response fields.

The section fields to update; include the section name and optionally its insertion position.

dataobjectoptional
Section update data containing the fields to change.

6 status codes
200Returns the complete updated section record.
dataobjectoptional
400Returned when the request is malformed, `name` is missing or empty, or both `insert_before` and `insert_after` are provided.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to update the section.
errorsarray<object>optional
404Returned when the requested action or section identified by `section_gid` does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the section from being updated.
errorsarray<object>optional

Error handling

The request must identify an existing section with section_gid and include a non-empty name in data. Do not provide both insert_before and insert_after; a 400 is returned for malformed or conflicting input. A 401 indicates missing authentication, a 403 indicates insufficient access, a 404 indicates that the section or action does not exist, and 500 indicates a server-side failure.