Skip to main content
GET
List context files

Authorizations

Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Query Parameters

userId
string<uuid>

Requires Organization API keys. The ID of the user who own the file(s).

scope
enum<string>
required

Filters results by who the context belongs to:

  • organiztion - Organization-level files used by default in all agent sessions in the organization
  • personal - Files owned by the caller, which the agent only reads in sessions with the caller
Available options:
organization,
personal
Example:

"personal"

Response

The context files in the specified scope.

files
object[]
required

Every context file in the specified scope, by name. To read the file's body content, use the Read a context file endpoint.