---
title: "Posts details for a device initiating a new (OAuth2.0) client device authorization flow in exchange for a one-time-use code"
method: POST
path: "/client/device_authorizations"
---

# Posts details for a device initiating a new (OAuth2.0) client device authorization flow in exchange for a one-time-use code

`POST /client/device_authorizations`

## Request

- Base URL: `https://api.border0.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.border0.com/client/device_authorizations`
- Auth: none declared

## Request body

- V1PostClientDeviceAuthorizationRequest
  - `device_os` string
  - `organization` string

## Response `200`

OK

- V1PostClientDeviceAuthorizationResponse
  - `authorization_endpoint` string
  - `authorization_endpoint_code_query_param` string
  - `code` string
  - `token_endpoint` string
  - `token_endpoint_code_header` string
  - `token_endpoint_poll_interval` integer
  - `token_endpoint_poll_max_attempts` integer

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

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