Sample - Asana API
GET/sections/{section_gid}

Get a section

Retrieves the complete record for a single section. Use opt_fields to request additional top-level or nested section and project properties.

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

1 parameter
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.

6 status codes
200Returns the complete section record in the response data.
dataobjectoptional
400Returned when the request is missing required information or contains malformed input.
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 access the section.
errorsarray<object>optional
404Returned when the requested action is unknown or no section exists for the specified `section_gid`.
errorsarray<object>optional
500Returned when a server-side problem prevents the section from being retrieved.
errorsarray<object>optional

Error handling

A 400 is returned when the request is malformed, while a 401 indicates that no valid authentication token was provided. A 403 indicates that the authenticated user cannot access the section, and a 404 indicates that the section identified by section_gid does not exist. A 500 indicates a server-side failure.