---
title: "Create an agent for an auto-pair installation"
method: POST
path: "/v1/agent"
tags: ["Agents"]
---

# Create an agent for an auto-pair installation

`POST /v1/agent`

## Request body

- object
  - `device_id` string, required — ID of a device
  - `display_name` string, required — Customizable display name

## Response `201`

Created

- AgentPairCode — Agent id and pair code
  - `agent_id` string, required — ID of an agent
  - `display_name` string, required — Customizable display name
  - `pair_code` string, required — Short code used to identify an unpaired agent

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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