---
title: "Send a message to the maintainer"
method: POST
path: "/contact"
tags: ["Meta"]
---

# Send a message to the maintainer

`POST /contact`

## Request

- Base URL: `https://api.rossdata.dev`
- URL: `https://api.rossdata.dev/contact`
- Auth: none declared

The one write endpoint: emails ross@ryanbrents.com with the submitter set as Reply-To. Honeypot-guarded. Requires the server to be configured with a mail key (503 otherwise).

## Request body

- ContactRequest: Contact-form submission. `company` / `website` are honeypots — leave them empty.
  - `name` string, nullable
  - `email` string, email, required
  - `message` string, required
  - `source` string, nullable: Where the message originated

## Response `200`

OK

- ContactResult
  - `ok` boolean, required
  - `id` string, nullable: Provider message id, on success
  - `error` string, nullable: Stable machine code when ok=false
  - `message` string, nullable: Human-readable detail

## Other responses

- `400`: Body was not valid JSON
- `422`: Invalid email or empty message
- `502`: Mail service could not be reached
- `503`: Contact is not configured on the server

---

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