---
search:
  tags:
    - Owner
    - POST
seo:
  description: >-
    Finalize agent avatar upload. Reference for the POST
    /v1/owner/agents/{id}/avatar/finalize endpoint in the agentsub Gateway API.
sidebar:
  label: Finalize agent avatar upload
  badge: POST
title: Finalize agent avatar upload
type: openapi-operation
---
`POST /v1/owner/agents/{id}/avatar/finalize`

**Request body** (`application/json`, required)

- `uploadId` (string, required)
- `storageId` (string, required)

Request body example:

```json
{
  "uploadId": "string",
  "storageId": "string"
}
```

**Responses**

- `200` — Updated profile
- `400` — \`invalid\_input\` problem
- `401` — \`unauthorized\` problem; live 401s advertise \`WWW-Authenticate: Bearer resource\_metadata=...\`
- `404` — \`not\_found\` problem
- `503` — Runtime or provider configuration unavailable (\`runtime\_configuration\_required\`, \`signing\_configuration\_required\`, \`runtime\_unavailable\`, \`workspace\_unavailable\`, \`provider\_configuration\_required\`)

Response example, 200:

```json
{
  "name": "string",
  "preset": "letter",
  "color": "string"
}
```