> ## Documentation Index
> Fetch the complete documentation index at: https://www.openrevenue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update project

> Updates project settings. Requires a write-scoped API key and project ownership. Pass any combination of name, timeZone, and publicStatsEnabled.

**domain** `string` *required*

Your project's domain, e.g. `example.com`.

**name** `string`

New display name (max 80 characters).

**timeZone** `string`

Valid IANA timezone, e.g. America/New\_York.

**publicStatsEnabled** `boolean`

Enable or disable the public stats page.

## Response

**id** `string`

Unique project identifier.

**name** `string`

Updated display name.

**domain** `string`

Normalized project domain.

**timeZone** `string`

IANA timezone after the update.

**publicStatsEnabled** `boolean`

Public stats setting after the update.

**installationSeenAt** `string | null`

ISO timestamp when the tracker was first seen, or null.

## Errors

| Status | Error | Description |
| - | - | - |
| `400` | `No valid fields to update` | The body had no recognized fields, or values failed validation. |
| `401` | `Invalid or missing API key` | The Authorization header is missing or the Bearer token is invalid. |
| `403` | `API key is read-only` | The key does not include the write scope. |
| `404` | `Project not found` | No project with that domain exists for the owner, or the caller is not the owner. |
| `429` | `Too many requests` | Rate limit exceeded. |

```javascript JavaScript theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
const res = await fetch("https://api.openrevenue.com/api/v1/projects/example.com", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${OPENREVENUE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Example", publicStatsEnabled: true }),
})

const updated = await res.json()
```

```bash cURL theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
curl -X PATCH "https://api.openrevenue.com/api/v1/projects/example.com" \
  -H "Authorization: Bearer openrevenue_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Example", "publicStatsEnabled": true }'
```

```json 200 theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
{
  "id": "44cc0aa0-912f-4067-83c7",
  "name": "Example",
  "domain": "example.com",
  "timeZone": "Africa/Casablanca",
  "publicStatsEnabled": true,
  "installationSeenAt": "2026-05-01T12:00:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.