---
title: "Admin Upsert Handle"
method: POST
path: "/v1/admin/handles"
tags: ["admin"]
---

# Admin Upsert Handle

`POST /v1/admin/handles`

## Request

- Base URL: `https://www.tandem-cc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tandem-cc.com/v1/admin/handles`
- Auth: none declared

Create or update a handle row.

Body:
  {
    "handle": "jack@tandem-cc.com",             # required
    "display_name": "Jack",                  # optional
    "signed_by": "jack",                     # optional (attribution short form)
    "is_tandem": true                        # optional (default true when
                                             #           we're provisioning
                                             #           internal handles)
  }

## Headers

- `X-Tandem-Api-Key` string, nullable

## Request body

- object

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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