---
title: "The team’s own address"
method: POST
path: "/api/v1/mail/hosted"
tags: ["Desk"]
---

# The team’s own address

`POST /api/v1/mail/hosted`

## Request

- Base URL: `http://localhost:5180`
- URL: `http://localhost:5180/api/v1/mail/hosted`
- Auth: API key in cookie `better-auth.session_token`

Returns the team’s own address at the Dardaris inbox domain, making it first where the team has a plan running and none yet. Asking again returns the same address. Mail sent to it is filed exactly as mail read from a connected mailbox is. Replies to mail that came to it go out from it too, sent through Cloudflare on the Dardaris domain, whether written by hand or by a mail run. With no plan running nothing is made and `address` is null.

## Response `200`

The address, or null with no plan.

- object
  - `ok` unknown, required
  - `data` object, required
    - `domain` string, required: The domain every team address sits at.
    - `address` string, nullable, required: The team’s own address, or null where the team has no plan running and so no address yet.
    - `mailboxId` string, nullable, required: The mailbox on the portfolio that this address files into.
    - `renamable` boolean, required: Whether the name before the @ may still change. It is fixed once the first message arrives.
  - `meta` object, required
    - `requestId` string, required: Echoed in the x-request-id header. Quote it in a bug report.

## Other responses

- `401`: No session. Sign in first.

---

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