Sign in
Access requests

Get access requests

Returns the pending access requests for a target object or a target object filtered by user.

get/access_requests

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/access_requests
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token)

Query parameters

targetstring required

Globally unique identifier for the target object.

userstring

A string identifying a user. This can either be the string "me", an email, or the gid of a user.

opt_prettyboolean

Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved access requests.

Example response

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "access_request",
      "message": "Please grant me access to this resource.",
      "approval_status": "pending",
      "requester": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      },
      "target": {
        "gid": "12345",
        "resource_type": "project"
      }
    }
  ]
}

Changes

No operation changes recorded.