Download a public user avatar image.

GET

/api/avatars/{filename}

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/api/avatars/example

Streams a tenant-owned user avatar from the private PUBLIC_ASSETS bucket through the public tenant API origin. Object keys are resolved from the request tenant and cannot be selected by the caller. Avatar filenames are content-versioned and successful responses use no-store cache controls so that replacement and deletion take effect without retaining personal images in a shared cache. Unsupported filenames and missing or deleted objects return a not-found error.

Parameters

Path Parameters

filename

required

string

Stored avatar object filename, including the image extension.

Responses

200

Avatar image bytes.

string format: binary

string format: binary

string format: binary

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}