---
title: "Create a device access request."
method: POST
path: "/access/requests"
tags: ["access"]
---

# Create a device access request.

`POST /access/requests`

Endpoint to create (device) access requests. The response contains the href to poll for the status of the request.

## Request body

- object
  - `clientId` string, required — Client identifier.
  - `description` string, required — Description of device.

## Response `200`

Request status

- object — Request response
  - `state` 'PENDING' | 'FAILED' | 'COMPLETED', required
  - `href` string — Path where the status of the request can be checked.

## Other responses

- `default` — Failed operation

---

[API](https://skmtc.net/signalk/apis/signal-k-security-api.md) · [All operations](https://skmtc.net/signalk/apis/signal-k-security-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalk/signal-k-security-api/versions/9c4fd7143750/schema)