Get a team's access requests

GET

/teams/:teamId/access-requests

GET

/teams/:teamId/access-requests

$ curl https://api.postman.com/teams/123/access-requests \
>      -H "x-api-key: <apiKey>"

1 {
2   "data": [
3     {
4       "createdAt": "2025-10-10T18:54:09.000Z",
5       "updatedAt": "2025-10-10T18:54:09.000Z",
6       "id": 1,
7       "role": "TEAM_DEVELOPER",
8       "requestType": "REQUEST_TO_ADD_MEMBERS",
9       "reason": "Needs the developer role.",
10       "status": "Requested",
11       "entityType": "user",
12       "entityId": 1317604,
13       "objectType": "team",
14       "objectId": 1,
15       "createdBy": 12345678
16     },
17     {
18       "createdAt": "2025-10-10T18:57:58.000Z",
19       "updatedAt": "2025-10-10T18:57:58.000Z",
20       "id": 2,
21       "role": "TEAM_MANAGER",
22       "requestType": "UPGRADE_ROLE",
23       "reason": "I need the team manager role for my team.",
24       "status": "Requested",
25       "entityType": "user",
26       "entityId": 12345678,
27       "objectType": "team",
28       "objectId": 2,
29       "createdBy": 12345678
30     }
31   ],
32   "metadata": {
33     "nextCursor": null
34   }
35 }

Gets a team's pending access requests.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

teamIdintegerRequired

The team's ID.

Query parameters

cursorstringOptional

The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter.

limitintegerOptionalDefaults to 50

The maximum number of rows to return in the response.

Response

Successful Response

datalist of objects

A list of access requests.

metadataobject

The response's meta information for paginated results.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors