# Update an ASO folder

Rename or recolor a private ASO folder.

## Contract status

Preview contract: these routes and tools are implemented in the shared contract, but the public host, customer API access and OAuth flow have not been deployment verified.

## Endpoint: PATCH /v1/aso/folders/{folderId}

- Method: `PATCH`
- Path: `/v1/aso/folders/{folderId}`
- Authentication: Bearer API credential or OAuth access token
- Required scope: `content:write`
- MCP tool: `update_aso_folder`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `folderId` | path | uuid | yes | ASO folder id. |
| `name` | body | string | yes | Optional name. |
| `color` | body | #rrggbb | yes | Optional color. |

## Known errors

- 400 invalid_request for an invalid filter, identity or limit.
- 401 authentication_required for a missing or invalid credential.
- 402 subscription_required when access is not entitled.
- 403 authorization_required for a missing scope or unavailable preview access.
- 404 not_found when the record is outside the accessible catalogue.
- 429 rate_limited; honor Retry-After when present.
- 409 conflict when the write would duplicate an exclusive row.

## Request

Changes the private folder only.

```
curl --request PATCH 'https://api.peekpanda.com/v1/aso/folders/44444444-4444-4444-8444-444444444444' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \
  --header 'content-type: application/json' \
  --data '{"name":"Priorities","color":"#2563eb"}'
```

## Response

The updated folder.

```
{
  "id": "44444444-4444-4444-8444-444444444444",
  "name": "Priorities",
  "color": "#2563eb",
  "createdAt": "2026-09-06T00:00:00.000Z",
  "updatedAt": "2026-09-06T00:00:00.000Z"
}

```

## Source

Dated public App Store search results and suggestion observations for the US English storefront. Positions are observed result order. Difficulty and demand are directional indicators, not search volume or advertising data.

## Refresh

This read returns stored observations. Use the related refresh command when newer evidence is needed.