---
title: "Get comment settings"
description: "The owner, anyone the computer is shared with and, when the computer is public, any signed-in person (a person's own sign-in, not an organization API key or the computer's runtime token)."
canonical: "https://www.cool.computer/docs/api-reference/comments/get-comment-settings"
---
# Get comment settings

> The owner, anyone the computer is shared with and, when the computer is public, any signed-in person (a person's own sign-in, not an organization API key or the computer's runtime token).

```http
GET https://api.cool.computer/api/computers/{id}/comment-settings
```

The owner, anyone the computer is shared with and, when the computer is public, any signed-in person (a person's own sign-in, not an organization API key or the computer's runtime token). Reports whether comments are on for the computer. They are on until the owner switches them off. To the owner alone it also reports emails: which comments other people leave are emailed to them.

## 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.

## 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.

## Responses

- `200`: The computer's comment switch.
  - `application/json` (object)
    - `enabled` (boolean)
    - `emails` ("all" or "for_you" or "none"): Which comments other people leave are emailed to the owner; only the owner reads or sets it.
- `401`: Unauthorized.
- `404`: Not Found.
- `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 "https://api.cool.computer/api/computers/$PARAM_ID/comment-settings" \
  -H "authorization: Bearer $TOKEN"
```
