Assets

List the characters in your asset library

Changed on Oct 20, 2026

A character is a named set of images saved in the same library, kept in the order arranged in the console. It references those assets instead of copying them: deleting a character never deletes its images, and deleting an image removes it from every character. Characters are created and edited in the console; this API only reads them.

The key decides the library exactly as for GET /api/v1/assets. Each image is an asset with its stable uri (popnow://a/<id>), usable in generation requests made with keys of the same workspace, and a private previewUrl signed for at most 20 minutes. cover is the cover image (null while the character has no images).

Newest first, one page at a time: pass the previous page's nextCursor as cursor. Pass assetId to list only the characters that contain that asset. Responses are private, no-store; reading characters shares the limit of 60 requests per minute per account with reading assets.

get/api/v1/assets/entities

Request

Base URL: https://api.popnow.ai
URL: https://api.popnow.ai/api/v1/assets/entities
Auth: HTTP bearer

Query parameters

kind'character'

Only character exists today; omitting it means character.

assetIdstring

Only characters that contain this asset.

cursorstring

limitinteger

Response

One page of characters.

code200 required

msg'success' required

request_idstring required

Correlation identifier. Include it in support requests.

Changes

Oct 20, 2026fede911a6e9b Revision changes
- warning
  added the new agent_project_budget enum value to the // response property for the response status
- warning
  added the new agent_project_budget enum value to the // response property for the response status
- warning
  added the new agent_project_budget enum value to the // response property for the response status
- warning
  added the new agent_project_budget enum value to the // response property for the response status
- warning
  added the new agent_project_budget enum value to the // response property for the response status
- warning
  added the new agent_quota enum value to the // response property for the response status
- warning
  added the new agent_quota enum value to the // response property for the response status
- warning
  added the new agent_quota enum value to the // response property for the response status
- warning
  added the new agent_quota enum value to the // response property for the response status
- warning
  added the new agent_quota enum value to the // response property for the response status
- warning
  added the new agent_rate enum value to the // response property for the response status
- warning
  added the new agent_rate enum value to the // response property for the response status
- warning
  added the new agent_rate enum value to the // response property for the response status
- warning
  added the new agent_rate enum value to the // response property for the response status
- warning
  added the new agent_rate enum value to the // response property for the response status
- warning
  added the new agent_skill_invalid enum value to the // response property for the response status
- warning
  added the new agent_skill_invalid enum value to the // response property for the response status
- warning
  added the new agent_skill_invalid enum value to the // response property for the response status
- warning
  added the new agent_skill_invalid enum value to the // response property for the response status
- warning
  added the new agent_skill_invalid enum value to the // response property for the response status
- warning
  added the new agent_skill_turns enum value to the // response property for the response status
- warning
  added the new agent_skill_turns enum value to the // response property for the response status
- warning
  added the new agent_skill_turns enum value to the // response property for the response status
- warning
  added the new agent_skill_turns enum value to the // response property for the response status
- warning
  added the new agent_skill_turns enum value to the // response property for the response status
- warning
  added the new agent_turns enum value to the // response property for the response status
- warning
  added the new agent_turns enum value to the // response property for the response status
- warning
  added the new agent_turns enum value to the // response property for the response status
- warning
  added the new agent_turns enum value to the // response property for the response status
- warning
  added the new agent_turns enum value to the // response property for the response status
- warning
  added the new price_changed enum value to the // response property for the response status
- warning
  added the new price_changed enum value to the // response property for the response status
- warning
  added the new price_changed enum value to the // response property for the response status
- warning
  added the new price_changed enum value to the // response property for the response status
- warning
  added the new price_changed enum value to the // response property for the response status
- warning
  added the new team_allowance_reached enum value to the // response property for the response status
- warning
  added the new team_allowance_reached enum value to the // response property for the response status
- warning
  added the new team_allowance_reached enum value to the // response property for the response status
- warning
  added the new team_allowance_reached enum value to the // response property for the response status
- warning
  added the new team_allowance_reached enum value to the // response property for the response status
- warning
  added the new team_limit_reached enum value to the // response property for the response status
- warning
  added the new team_limit_reached enum value to the // response property for the response status
- warning
  added the new team_limit_reached enum value to the // response property for the response status
- warning
  added the new team_limit_reached enum value to the // response property for the response status
- warning
  added the new team_limit_reached enum value to the // response property for the response status
- warning
  added the new team_role_cannot_spend enum value to the // response property for the response status
- warning
  added the new team_role_cannot_spend enum value to the // response property for the response status
- warning
  added the new team_role_cannot_spend enum value to the // response property for the response status
- warning
  added the new team_role_cannot_spend enum value to the // response property for the response status
- warning
  added the new team_role_cannot_spend enum value to the // response property for the response status
- warning
  added the new team_wallet_empty enum value to the // response property for the response status
- warning
  added the new team_wallet_empty enum value to the // response property for the response status
- warning
  added the new team_wallet_empty enum value to the // response property for the response status
- warning
  added the new team_wallet_empty enum value to the // response property for the response status
- warning
  added the new team_wallet_empty enum value to the // response property for the response status
- warning
  added the new web_fetch enum value to the // response property for the response status
- warning
  added the new web_fetch enum value to the // response property for the response status
- warning
  added the new web_fetch enum value to the // response property for the response status
- warning
  added the new web_fetch enum value to the // response property for the response status
- warning
  added the new web_fetch enum value to the // response property for the response status

Operation history