Skip to main content
GET
List knowledge files linked to an agent

Authorizations

Authorization
string
header
required

OAuth2 Authorization Code flow

Path Parameters

id
string
required

Agent ID

Query Parameters

expand
string

Comma-separated fields to expand. Supports selection with brackets (e.g., "createdBy,updatedBy" or "targets.company[icon,tradeName]").

Example:

"createdBy"

page_size
number
default:20

Number of items to return per page

Required range: 1 <= x <= 100
Example:

100

start_cursor
string

Opaque cursor for pagination. Use the next_cursor from previous response.

Example:

"eyJjcmVhdGVkX3RpbWUiOiIyMDI0LTExLTE1VDEwOjAwOjAwLjAwMFoiLCJpZCI6InBhZ2VfYWJjMTIzIn0="

filter
string

Stripe-like search query filter.

Syntax:

  • Exact match: field:"value"
  • Wildcards: field:"prefix*", field:"*suffix", field:"*contains*"
  • Numeric: field>100, field>=100
  • Null check: field:null
  • Negation: -field:"value"
  • Boolean: field1:"a" AND field2:"b"

Examples:

  • status:"uploaded" - Filter by status
  • filename:"*2024*.pdf" - Filter by filename with wildcard
  • status:"uploaded" AND classification.status:"completed" - Combined filter
Example:

"status:\"uploaded\""

fields
string

Optional comma-separated list of extra fields to include. Supported values: "patterns.data", "extract.data", "insights.facts".

Example:

"patterns.data"

Response

Agent knowledge files

object
string
required
Example:

"list"

results
object[]
required
has_more
boolean
required
next_cursor
string | null
type
string