Skip to main content
GET
/
assets
/
files
List Files
curl --request GET \
  --url https://api.example.com/assets/files \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "resource_uri": "<string>",
      "name": "<string>",
      "key": "<string>",
      "project_id": "<string>",
      "created_by": "<string>",
      "owner_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "content_type": "<string>",
      "size": 123,
      "description": "<string>",
      "tags": []
    }
  ],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total_items": 1,
    "total_pages": 1,
    "next_page": 123,
    "prev_page": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.emergence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Project-ID
string | null

Query Parameters

page
integer
default:1

Page number (starts at 1)

Required range: x >= 1
limit
integer
default:20

Items per page

Required range: 1 <= x <= 100
search
string | null

Search in name and description

tags
string | null

Filter by tags (comma-separated)

sort
string | null

Sort: field:order,... (e.g., name:asc,created_at:desc)

content_type
string | null

Filter by content type. Exact match or prefix with wildcard (e.g., 'image/*', 'application/pdf')

key_prefix
string | null

Filter by key prefix (folder path, relative to project)

created_by
string | null

Filter by creator (e.g., 'user:alice')

owner_id
string | null
deprecated

Deprecated: use created_by instead. Will be removed in a future release.

Response

Successful Response

Paginated list response for files.

data
FileSummary · object[]
required
pagination
Pagination · object
required

Pagination metadata for list responses.