---
title: "Request access to a private page"
method: POST
path: "/v1/access-requests"
tags: ["Access requests"]
---

# Request access to a private page

`POST /v1/access-requests`

Signed-in user asks the artifact owner for viewer access (Google Drive style). Requires an email identity. Idempotent while a pending request exists.

## Request body

- object
  - `slug` string, required — Production slug of the private artifact.

## Response `200`

Request created or already pending

- object
  - `ok` boolean
  - `status` 'created' | 'pending'
  - `message` string

## Other responses

- `400` — Invalid request
- `404` — Resource not found

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)
