---
title: "Let a reader in, or turn them away"
method: POST
path: "/link-access-requests/{request_id}/resolve"
tags: ["link"]
---

# Let a reader in, or turn them away

`POST /link-access-requests/{request_id}/resolve`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/link-access-requests/{request_id}/resolve`
- Auth: HTTP bearer

Decides a request from someone outside a link's list, or from a reader asking to skip its NDA. Granting adds their email to the list, or lets them past the NDA, and emails them that they can open it.

## Path parameters

- `request_id` string, required

## Request body

- object
  - `grant` boolean, required

## Response `200`

The result.

- object
  - `id` string, required
  - `status` 'granted' | 'declined', required
  - `email` string, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)