Skip to main content
GET
List an agent’s files

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Path Parameters

agent_id
string
required

The agent’s id, e.g. billing or default.

Query Parameters

folder
string

Only the files in this folder, like /notes.

q
string

Search: only files whose path has the text containing this text (case-insensitive, up to 100 characters).

Maximum string length: 100
limit
integer

How many to return, 1 to 100. Without limit or cursor, the whole list in one page.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

include
string

total_count adds how many match across every page.

Example:

"total_count"

Response

OK

data
object[]
required
has_more
boolean
required
next_cursor
string | null
required

Pass as cursor to get the next page.

usage
object

How much of its limits the agent’s files use.

total_count
integer

How many match the filters across every page. Only with include=total_count.