# PUT /v1/sites/{id}

Update a site

Change the category of a site owned by the publisher: mainstream, adult or network. Prefer PATCH /v1/sites/{id}. Some changes on an approved site need review: the response is 202 and `pending_category` shows the requested value; the site keeps running with its current `category` until the review is done. Send the current category to cancel a pending request. Requires scope `publisher:write` (API key or web session); not available in view-as. Rate limit tier: `write`.

- Required scope: `publisher:write`
- Rate limit: `write` — 20 requests per 60-second window per API key or web session

## Parameters

| Name | In | Type | Required |
|---|---|---|---|
| `id` | path | integer | yes |

## Request body

```
{ category: "mainstream" | "adult" | "network" }
```

## Response

```
{ category: "mainstream" | "adult" | "network"; created_at: string; deleted_at: string | null; domain: string; id: integer; notes: string | null; pending_category: "mainstream" | "adult" | "network" | null; pending_category_at: string | null; publisher_note: string | null; status: "pending" | "approved" | "rejected"; zones_count: integer }
```

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

HTML documentation: https://agimone.com/en/developers/api/#update-site
API 2026-10
