---
title: "Record a step of the comment funnel"
description: "The comment layer's count of who starts a comment and who signs in to post one, for analytics only; it never carries words, names or emails."
canonical: "https://www.cool.computer/docs/api-reference/comments/record-a-step-of-the-comment-funnel"
---
# Record a step of the comment funnel

> The comment layer's count of who starts a comment and who signs in to post one, for analytics only; it never carries words, names or emails.

```http
POST https://api.cool.computer/api/computers/{id}/comments/events
```

The comment layer's count of who starts a comment and who signs in to post one, for analytics only; it never carries words, names or emails. Allowed for whoever may read the board: the owner, anyone the computer is shared with and, when it is public, any signed-in person, and a request with no credential at all on a public computer, as a signed-out visitor; a private computer answers anyone else 404. A signed-out step names the browser tab by visitor; signed in, signed_in with that visitor joins the tab's earlier steps to the account. A refused body says what is accepted in its resolution.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.
- No credential: the request is also answered without one.

## Parameters

- `id` (path, string, at least 1 characters, required): The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

## Request body

Required.

- `application/json` (object)
  - `step` ("started" or "sign_in_asked" or "sign_in_opened" or "signed_in", required)
  - `visitor` (string, pattern `^[0-9a-f]{32}$`): The browser tab's random id; required signed out and for signed_in.
  - `kind` ("comment" or "reply"): Only, and required, for sign_in_asked: what the press would have posted.
  - `has_ink` (boolean): For sign_in_asked: whether the comment carries a drawing.

## Responses

- `204`: Recorded.
- `400`: Bad Request. `invalid_body`: not a JSON object of these fields. `invalid_comment_step`: an unknown step, a visitor that is not 32 lowercase hex characters or is missing, or kind missing from sign_in_asked or sent with another step; the resolution lists what is accepted.
- `401`: Unauthorized.
- `403`: Forbidden. `comment_step_person_required`: the credential names no person, such as an organization API key; send the step signed in as yourself or signed out. A cookie request from another origin is also refused.
- `404`: Not Found. `comments_off`: comments are off for the computer, or nobody has claimed it. The computer itself is also 404 for anyone it is not shared with when it is private.
- `413`: Payload Too Large. A step is at most 1 KiB.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: Internal Server Error.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl -X POST "https://api.cool.computer/api/computers/$PARAM_ID/comments/events" \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  --data '{"step":"started"}'
```
