REVIEWITDocumentation
This page is generated from Catalogue publié — Asana — it cannot be corrected by hand.Correcting the contract corrects the page. Editing it here would be lost at the next generation.GENERATED ON 18 October 2026 · catalogue v23 · 2fe6febf
Generated referenceUp to date · generated on 18 October 2026

Collection Contracts — Asana

Machine translation, not yet reviewedThis page was translated by a model from the French version, which is authoritative. Read the French version.

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.

PathToken issued byToken audienceIdentifier authentication
asana.api.reviewit.service-accounthttps://app.asana.comhttps://app.asana.com/api/1.0service 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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
IsActivecontext, no effect on the reviewbooleanno
Teamscontext, no effect on the reviewtextno
Projectscontext, no effect on the reviewtextno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
IsActivecontext, no effect on reviewbooleanno
IsAdmincontext, no effect on reviewbooleanno
IsGuestcontext, no effect on reviewbooleanno
Teamscontext, no effect on reviewtextno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
MembershipKeyobject keytextyes
PortfolioGidcontext, no effect on reviewtextyes
PortfolioNamecontext, no effect on reviewtextno
UserGidcontext, no effect on reviewtextyes
UserNamecontext, no effect on reviewtextno
Emaildisplayed to recognize the objecttextyes
AccessLevelcontext, no effect on reviewtextno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Owneraccess subject to reviewlist of identitiesno
Publicevaluated by REVIEWIT policies (visibility)booleanno
Createdcontext, no effect on reviewdate and timeno
Membersaccess subject to reviewlist of identitiesno
ProjectCountcontext, no effect on reviewintegerno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Emaildisplayed to recognize the objecttextno
AdminScopecontext, no effect on reviewtextno
IsActivecontext, no effect on reviewbooleanno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
MembershipKeyobject keytextyes
ProjectGidcontext, no effect on reviewtextyes
ProjectNamecontext, no effect on reviewtextno
UserGidcontext, no effect on reviewtextyes
UserNamecontext, no effect on reviewtextno
Emaildisplayed to recognize the objecttextyes
AccessLevelcontext, no effect on reviewtextno
IsGuestcontext, no effect on reviewbooleanno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Teamcontext, no effect on reviewtextno
Owneraccess subject to reviewlist of identitiesno
Privacyevaluated by REVIEWIT policies (visibility)textno
Archivedcontext, no effect on reviewbooleanno
Createdcontext, no effect on reviewdate and timeno
Modifiedevaluated by REVIEWIT policies (date of last activity)date and timeno
Membersaccess subject to reviewlist of identitiesno
Followersaccess subject to reviewlist of identitiesno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
MembershipKeyobject keytextyes
TeamGidcontext, no effect on reviewtextyes
TeamNamecontext, no effect on reviewtextno
UserGidcontext, no effect on reviewtextyes
UserNamecontext, no effect on reviewtextno
Emaildisplayed to recognize the objecttextyes
IsAdmincontext, no effect on reviewbooleanno
IsGuestcontext, no effect on reviewbooleanno
IsLimitedAccesscontext, no effect on reviewbooleanno

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

NatureRuleOptions
Administration conditionrequiredthe Asana service account is created by a super-administrator of the organization (Asana Enterprise); its token grants full read access, verified by call
Membershiprequiredthe 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

FieldRoleTypeRequired
Gidobject keytextyes
Namedisplayed to recognize the objecttextyes
Descriptioncontext, no effect on reviewtextno
Visibilityevaluated by REVIEWIT policies (visibility)textno
Organizationcontext, no effect on reviewtextno
MemberCountcontext, no effect on reviewintegerno

13To go further #sec_b2bf5f50

  • Understanding a collection connection
  • Rights reference by resource
  • Reading a verdict
Esc
↑↓ navigate↵ openSee all results →