List Assets

GEThttps://api.konpro.ai/v1/asset/list

Fetch a paginated list of media assets associated with your account, optionally filtered by folder or file type.

Request History

TIME	STATUS	USER AGENT
Make a request to see history.

0 Requests This Month

cURL Request

shell

curl --request GET \
--url "https://api.konpro.ai/v1/asset/list?limit=50&file_type=image" \
--header "accept: application/json" \
--header "x-api-key: <your-api-key>"

Query Parameters

Parameter	Type	Description
folder_id	string	Filter assets to only those within the specified folder
file_type	string	Filter assets by type (e.g., image, video, audio)
limit	string	Number of assets to return per page (maximum 100)
token	string	Pagination token from previous response for next page

Response

Response Structure

Field	Type	Description
id	string	Unique identifier of the asset
name	string	Display name of the asset
file_type	string	Asset type (image, video, audio, etc.)
folder_id	string	ID of the parent folder, empty if root folder
created_ts	integer	Unix timestamp recording when asset was created
url	string	null

Pagination

•To fetch initial results, call without the token parameter.
•For subsequent pages, provide the token value from the last response.
•When token is empty or null, no more results are available.

Sample Response

json

{
  "assets": [
    {
      "id": "asset_123456",
      "name": "profile_image.jpg",
      "file_type": "image",
      "folder_id": "folder_789",
      "created_ts": 1640995200,
      "url": null
    },
    {
      "id": "asset_789012",
      "name": "video_clip.mp4",
      "file_type": "video",
      "folder_id": "",
      "created_ts": 1640995100,
      "url": null
    }
  ],
  "token": "next_page_token_abc123",
  "has_more": true
}

Notes

Requires API authentication.
Returns paginated list of assets with optional filtering.
Use folder_id to filter assets within specific folders.
Use file_type to filter by asset type (image, video, audio).
Maximum limit of 100 assets per request.
Use token for pagination to get next page of results.
When token is null, no more results are available.
Refer to Error Responses for error information.

Example Usage

Shell

curl --request GET \
--url "https://api.konpro.ai/v1/asset/list?limit=50&file_type=image" \
--header "accept: application/json" \
--header "x-api-key: <your-api-key>"

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Choose an example:

application/json

200 - Success

400 - Bad Request

Upload Asset Delete Asset