Collection Contracts — Asana
01How to read this page #sec_bba4e109
Each resource that REVIEWIT can collect for Asana has a published contract. It is read as an API reference: what REVIEWIT calls on the collected service and by what means, what the contract requires for the collection to execute, and the data that REVIEWIT retains. REVIEWIT only performs reads.
- Calls: the requests that REVIEWIT sends to the collected service, all in read mode.
- Requirements: each must be satisfied. Its nature indicates what it demands: a right to grant to the identifier, an administration condition (a setting or assignment at the provider that the token does not carry, verified by a real read call), or the identifier's membership in the connection's Asana organization. The rule states how many options are needed: « required » for the single option, « one of » when one is sufficient (they are ranked from narrowest to broadest: prefer the first), « all », or « N of M ».
- Operational conditions: what REVIEWIT verifies before each collection, beyond the requirements.
- Freshness: the maximum age of the verifications on which the verdict is based, set by each contract (here: verifications less than 24 h old; rights must be verified by a real call). REVIEWIT automatically redoes verifications it can perform within this period (token obtained, service responding); « Verify rights », in the connection menu, redoes them on demand. As long as the real call has not been made, the rights remain unverified.
- Data retained: the fields that REVIEWIT keeps from each object; the role indicates what the review does with it.
The verdict of each resource, for your connection, is read on its card. A resource that the connection does not collect can still be fed by importing a report (« Import a report »).
02How REVIEWIT verifies requirements #sec_4b0123b7
The Asana token does not carry its rights: the contract requires that they be verified by a real call, in read mode. REVIEWIT does not yet make this call for Asana: it verifies that the token is obtained and that the service responds, but not the rights listed here. Resources are displayed as « Not verified »; they can still be fed by importing a report (« Import a report »).
03Call paths #sec_cf8230c1
A path indicates which token REVIEWIT obtains for the identifier: who issues it and for which audience. The addresses called are listed in the calls of each resource; a path starting with « / » is called on the token's audience of its path.
| Path | Token issued by | Token audience | Identifier authentication |
|---|---|---|---|
| asana.api.reviewit.service-account | https://app.asana.com | https://app.asana.com/api/1.0 | service account |
04Directory · Guests #sec_b8689674
asana.directory.guests:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
External collaborators admitted to the organization
Calls
- GET /workspaces/{gid}/workspace_memberships (is_guest)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the connection's Asana organization |
Operational conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: verifications less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| IsActive | context, no effect on the review | boolean | no |
| Teams | context, no effect on the review | text | no |
| Projects | context, no effect on the review | text | no |
05Directory · Users #sec_1061454b
asana.directory.users:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Organization accounts and their activity status
Calls
- GET /workspaces/{gid}/users
- GET /workspaces/{gid}/workspace_memberships
- GET /users/{user_gid}/teams?organization={gid} (Teams field)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| IsActive | context, no effect on review | boolean | no |
| IsAdmin | context, no effect on review | boolean | no |
| IsGuest | context, no effect on review | boolean | no |
| Teams | context, no effect on review | text | no |
06Portfolios · Portfolio members #sec_bdfc2222
asana.portfolios.memberships:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Members of a portfolio and their access level. Line key: PortfolioGid | UserGid.
Calls
- GET /portfolios/{gid}/portfolio_memberships
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| PortfolioGid | context, no effect on review | text | yes |
| PortfolioName | context, no effect on review | text | no |
| UserGid | context, no effect on review | text | yes |
| UserName | context, no effect on review | text | no |
| displayed to recognize the object | text | yes | |
| AccessLevel | context, no effect on review | text | no |
07Portfolios #sec_c80b6d56
asana.portfolios.portfolios:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Portfolios, their owner, their members, and the number of projects they contain
Calls
- GET /portfolios?workspace={gid}
- GET /portfolios/{gid}/items
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Owner | access subject to review | list of identities | no |
| Public | evaluated by REVIEWIT policies (visibility) | boolean | no |
| Created | context, no effect on review | date and time | no |
| Members | access subject to review | list of identities | no |
| ProjectCount | context, no effect on review | integer | no |
08Privileged roles · Administrators #sec_901c7249
asana.privileged-roles.admins:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Organization administrators
Calls
- GET /workspaces/{gid}/workspace_memberships (is_admin)
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| displayed to recognize the object | text | no | |
| AdminScope | context, no effect on review | text | no |
| IsActive | context, no effect on review | boolean | no |
09Projects · Project members #sec_f9f5d31c
asana.projects.memberships:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Project members and their access level. Line key: ProjectGid | UserGid.
Calls
- GET /projects/{gid}/project_memberships
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| ProjectGid | context, no effect on review | text | yes |
| ProjectName | context, no effect on review | text | no |
| UserGid | context, no effect on review | text | yes |
| UserName | context, no effect on review | text | no |
| displayed to recognize the object | text | yes | |
| AccessLevel | context, no effect on review | text | no |
| IsGuest | context, no effect on review | boolean | no |
10Projects #sec_82d9dfcf
asana.projects.projects:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Organization projects, their owner, and their visibility
Calls
- GET /workspaces/{gid}/projects
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Team | context, no effect on review | text | no |
| Owner | access subject to review | list of identities | no |
| Privacy | evaluated by REVIEWIT policies (visibility) | text | no |
| Archived | context, no effect on review | boolean | no |
| Created | context, no effect on review | date and time | no |
| Modified | evaluated by REVIEWIT policies (date of last activity) | date and time | no |
| Members | access subject to review | list of identities | no |
| Followers | access subject to review | list of identities | no |
11Teams · Team members #sec_3fa08c09
asana.teams.memberships:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Team memberships, guests and limited access included. Line key: TeamGid | UserGid.
Calls
- GET /teams/{gid}/team_memberships
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| MembershipKey | object key | text | yes |
| TeamGid | context, no effect on review | text | yes |
| TeamName | context, no effect on review | text | no |
| UserGid | context, no effect on review | text | yes |
| UserName | context, no effect on review | text | no |
| displayed to recognize the object | text | yes | |
| IsAdmin | context, no effect on review | boolean | no |
| IsGuest | context, no effect on review | boolean | no |
| IsLimitedAccess | context, no effect on review | boolean | no |
12Teams #sec_29bcc8ef
asana.teams.teams:collect · contract revision 2, published on October 18, 2026 · path asana.api.reviewit.service-account
Organization teams and their visibility
Calls
- GET /workspaces/{gid}/teams
- GET /teams/{gid}/team_memberships
Requirements
| Nature | Rule | Options |
|---|---|---|
| Administration condition | required | the Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call |
| Membership | required | the identifier belongs to the Asana organization of the connection |
Operating conditions
- a token is obtained for the identifier
- the service https://app.asana.com/api/1.0 responds
Freshness: checks less than 24 h old; rights must be verified by a real call.
Data retained
| Field | Role | Type | Required |
|---|---|---|---|
| Gid | object key | text | yes |
| Name | displayed to recognize the object | text | yes |
| Description | context, no effect on review | text | no |
| Visibility | evaluated by REVIEWIT policies (visibility) | text | no |
| Organization | context, no effect on review | text | no |
| MemberCount | context, no effect on review | integer | no |
13To go further #sec_b2bf5f50
- Understanding a collection connection
- Rights reference by resource
- Reading a verdict