List Access Requests

GET

https://wf-api.merge.dev/api/v1/tool-access/requests

GET

/api/v1/tool-access/requests

curl https://wf-api.merge.dev/api/v1/tool-access/requests \
     -H "Authorization: Bearer <token>"

{
  "results": [
    {
      "id": "string",
      "person": {
        "id": "string",
        "name": "string"
      },
      "tools": [
        {
          "connector": "string",
          "tool": "string"
        }
      ],
      "reason": "string",
      "status": "PENDING",
      "active": true,
      "requested_expires_at": "2024-01-15T09:30:00Z",
      "expires_at": "2024-01-15T09:30:00Z",
      "reviewed_by_person_id": "string",
      "decision_note": "string",
      "decided_at": "2024-01-15T09:30:00Z",
      "revoked_by_person_id": "string",
      "revoked_at": "2024-01-15T09:30:00Z",
      "revoke_note": "string",
      "canceled_at": "2024-01-15T09:30:00Z",
      "created_at": "2024-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string"
}

Requires the view_tool_access permission.

Authentication

AuthorizationBearer

An organization API key (mfw_org_key_...), sent as Authorization: Bearer <key>. Create one under Settings → API keys.

Query parameters

statusenum or nullOptional

A list filter: a status, except APPROVED is approvals still in force and EXPIRED is approvals whose end date has passed.

person_idstring or nullOptionalformat: "uuid"

searchstring or nullOptional<=100 characters

limitintegerOptional1-100Defaults to 50

cursorstring or nullOptional

Response

Successful Response

resultslist of objects

next_cursorstring or null

Errors

422

Unprocessable Entity Error