---
search:
  tags:
    - Owner
    - POST
seo:
  description: >-
    Returns upload parameters for the durable Convex bridge… Reference for the
    POST /v1/owner/agents/{id}/avatar/upload endpoint in the agentsub Gateway
    API.
sidebar:
  label: Start agent avatar upload
  badge: POST
title: Start agent avatar upload
type: openapi-operation
---
Returns upload parameters for the durable Convex bridge (e.g. upload id/URL). Empty body.

`POST /v1/owner/agents/{id}/avatar/upload`

**Responses**

- `200` — Upload handle
- `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
{}
```