Asana: Sections schemas
8 Asana schemas with complete fields and constraints.
← Sections operations · All schemas
Add task to section — request body — body data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
task | string | Required within parent | The task to add to this section. |
insert_before | string | Optional | An existing task within this section before which the added task should be inserted. Cannot be provided together with insert_after. |
insert_after | string | Optional | An existing task within this section after which the added task should be inserted. Cannot be provided together with insert_before. |
Get a section — response body — data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | Model | Required within parent | Expand Get a section — response body — data data — sdk__Section Response |
Referenced models: Get a section — response body — data data — sdk__Section Response
Get a section — response body — data data — Section Response
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | JSON | Root | |
$ (allOf 1) | Model | All variants apply | Expand Get sections in a project — response body — data, next page data item |
$ (allOf 2) | object | All variants apply | |
$ (allOf 2).created_at | string | Optional | The time at which this resource was created. Format: date-time Read only: true |
$ (allOf 2).project | Model | Optional | Expand Search projects in a workspace — response body — data data item |
$ (allOf 2).projects | array | Optional | *Deprecated - please use project instead* Read only: true |
$ (allOf 2).projects[] | Model | Each item | Expand Search projects in a workspace — response body — data data item |
Referenced models: Search projects in a workspace — response body — data data item, Get sections in a project — response body — data, next page data item
Get a section — response body — data data — sdk__Section Response
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier. A *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project. |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | The name of the section (i.e. the text displayed as the section header). |
created_at | string | Optional | The time at which this resource was created. Format: date-time Read only: true |
project | Model | Optional | Expand Get a rate — response body — data data parent |
projects | array | Optional | *Deprecated - please use project instead* Read only: true |
projects[] | Model | Each item | Expand Get a rate — response body — data data parent |
Referenced models: Get a rate — response body — data data parent
Get sections in a project — response body — data, next page
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | array | Required within parent | |
data[] | Model | Each item | Expand Get a section — response body — data data — sdk__Section Response |
next_page | Model | Optional | Expand Get goals — response body — data, next page next page |
Referenced models: Get goals — response body — data, next page next page, Get a section — response body — data data — sdk__Section Response
Get sections in a project — response body — data, next page data item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | A *section* is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project. |
gid | string | Optional | Globally unique identifier of the resource, as a string. Read only: true |
resource_type | string | Optional | The base type of this resource. Read only: true |
name | string | Optional | The name of the section (i.e. the text displayed as the section header). |
Move or Insert sections — request body — body data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
section | string | Required within parent | The section to reorder. |
before_section | string | Optional | Insert the given section immediately before the section specified by this parameter. |
after_section | string | Optional | Insert the given section immediately after the section specified by this parameter. |
Update a section — request body — body data
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
name | string | Required within parent | The text to be displayed as the section name. This cannot be an empty string. |
insert_before | string | Optional | An existing section within this project before which the added section should be inserted. Cannot be provided together with insert_after. |
insert_after | string | Optional | An existing section within this project after which the added section should be inserted. Cannot be provided together with insert_before. |