---
title: "Request attaching an additional email to the current principal"
method: POST
path: "/agent/v1/control-plane/emails"
tags: ["ControlPlane"]
---

# Request attaching an additional email to the current principal

`POST /agent/v1/control-plane/emails`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/agent/v1/control-plane/emails`
- Auth: none declared

Authenticated + step-up (authenticator.register). Sends a single-use confirmation link to the address. The response is GENERIC regardless of the email's state (free / already attached / owned by another principal) — no account-existence oracle. Conflicts surface only at verify, after inbox possession is proven.

## Request body

- object
  - `email` string, required

## Response `200`

Generic acknowledgement (sent if attachable)

- object

## Other responses

- `403`: STEP_UP_REQUIRED

---

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