User assets overview

User assets are the calling user's own uploads, such as an avatar or cover image.

The user asset object

Attributes

• asset_url string

  The asset's relative path.

• attributes string

  File metadata, such as name, type, and size.

• content_type string

  The file's MIME type, for example image/png.

• created_at string (date-time)

  When the user asset was created.

• updated_at string (date-time)

  When the user asset was last updated.

• created_by_id string (uuid)

  The user who created the user asset.

• updated_by_id string (uuid) or null

  The user who last updated the user asset. null until someone updates it.

• entity_type string

  What the upload is for: USER_AVATAR or USER_COVER.

• id string (uuid)

  Unique identifier.

• is_uploaded boolean

  Whether the upload has been confirmed.

• name string

  The file name.

• size number

  The file size in bytes.

• user_id string (uuid)

  id of the user the asset belongs to.

Response200

{
  "asset_url": "https://example.com",
  "attributes": null,
  "content_type": "example",
  "created_at": "2026-01-14T09:22:41.478363Z",
  "created_by_id": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "entity_type": "example",
  "id": "b7e42a19-3c5d-4f80-9a26-8d1c0f4e7b53",
  "is_uploaded": false,
  "name": "Example name",
  "size": 1,
  "user_id": "f960d3c2-8524-4a41-b8eb-055ce4be2a7f"
}

Endpoints

Method	Path	Description
GET	/api/v2/users/me/assets/	List user assets
GET	/api/v2/users/me/assets/{pk}/	Get a user asset
POST	/api/v2/users/me/assets/	Create a user asset upload
DELETE	/api/v2/users/me/assets/{pk}/	Delete a user asset
PATCH	/api/v2/users/me/assets/{pk}/	Confirm a user asset upload

Response shaping

Every user asset read accepts ?fields= for sparse responses. See Sparse fields. Errors follow the shared problem+json contract.