---
title: "Submit a comment on an open RFC round"
method: POST
path: "/api/rfc/{id}/comments"
tags: ["rfc"]
---

# Submit a comment on an open RFC round

`POST /api/rfc/{id}/comments`

## Request

- Base URL: `https://aioq.org`
- URL: `https://aioq.org/api/rfc/{id}/comments`
- Auth: none declared

A comment becomes part of a public review record, so a real name and a working email address are required; the email is stored so AIO can reach the commenter about this round and is never published. Every comment is stored as `pending` and published only after review — nothing appears automatically. Rate-limited to 10 requests per 10 minutes per client. A comment on a round that is not accepting comments, or whose window has closed, is rejected with 410.

## Path parameters

- `id` string, required

## Request body

- object
  - `author` object, required
    - `name` string, required: Published with the comment.
    - `email` string, email, required: Stored so AIO can reach the commenter about this round. Never published.
    - `affiliation` string: Optional. Published with the comment.
  - `position` 'support' | 'object' | 'comment', required
  - `body` string, required

## Response `201`

Comment stored, pending review.

- object
  - `id` string
  - `rfcId` string
  - `status` string
  - `position` string
  - `closesAt` string
  - `note` string

## Other responses

- `400`: Validation failed; `details` lists each problem.
- `404`: No such RFC round.
- `410`: The comment window is closed (or has not opened yet).
- `429`: Rate limit exceeded.
- `503`: Comment storage unavailable on this deployment; the input was still validated.

---

[API](https://skmtc.dev/aioq/apis/aio-public-api.md) · [All operations](https://skmtc.dev/aioq/apis/aio-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aioq/apis/aio-public-api/revisions/377b76120162?raw)