---
updatedAt: 2025-09-13T02:51:44.000Z
agentTools:
  projectIndex: https://developers.asana.com/llms.txt
---

# Access requests

### AccessRequest

| Property                  | Type   | Description                                                                                                                                                                                                     |
| ------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gid`                     | string | Globally unique identifier of the resource, as a string.                                                                                                                                                        |
| `resource_type`           | string | The base type of this resource.                                                                                                                                                                                 |
| `message`                 | string | The message included in the access request, if any.                                                                                                                                                             |
| `approval_status`         | string | The current approval status of the request. <details><summary>Click to show all enum values</summary><ul><li><code>approved</code></li><li><code>denied</code></li><li><code>pending</code></li></ul></details> |
| `requester`               | object | A *user* object represents an account in Asana that can be given access to various workspaces, projects, and tasks.                                                                                             |
| `requester.gid`           | string | Globally unique identifier of the resource, as a string.                                                                                                                                                        |
| `requester.resource_type` | string | The base type of this resource.                                                                                                                                                                                 |
| `requester.name`          | string | *Read-only except when same user as requester*. The user's name.                                                                                                                                                |
| `target`                  | object | A *target id* object represents the target resource that the requester wants access to.                                                                                                                         |
| `target.gid`              | string | Globally unique identifier of the resource, as a string.                                                                                                                                                        |
| `target.resource_type`    | string | The base type of this resource.                                                                                                                                                                                 |

**Example JSON for `AccessRequest`:**

```json
{
  "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"
  }
}
```