---
title: "Create an agent identity; the key is returned once (organization key)"
method: POST
path: "/api/v1/tower/agents"
tags: ["Tower"]
---

# Create an agent identity; the key is returned once (organization key)

`POST /api/v1/tower/agents`

## Request

- Base URL: `https://overwing.ai`
- URL: `https://overwing.ai/api/v1/tower/agents`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `scopes` string[], required: Operation names, or * for every operation

## Response `201`

Agent with its key

- object
  - `agent_id` string
  - `name` string
  - `scopes` string[]
  - `status` 'active' | 'revoked'
  - `key_prefix` string
  - `created_at` string
  - `last_used_at` string, nullable
  - `revoked_at` string, nullable
  - `key` string
  - `key_shown_once` boolean

## Other responses

- `400`: Invalid request
- `409`: Active agent limit reached

---

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