API v1
Agents
Agents Workspace

Workspace: Glob

Find files in the agent's workspace matching a glob pattern.

post/v1/agents/{agent_id}/workspace/glob

Request

  • Base URL
    https://api.xpander.ai (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header x-api-key

Path parameters

agent_idstring required

Request body

patternstring required

Glob pattern for file matching. Supports ** for recursive matching, * for wildcards.

root_dirstring

Root directory to search from, relative to workspace root.

max_resultsinteger

Maximum number of results to return. Prevents excessive output for broad patterns.

Example request

{
  "pattern": "**/*.py",
  "root_dir": "src"
}

Response

Successful Response

matchesstring[]

List of matched file paths

total_foundinteger

Total number of files matching the pattern

truncatedboolean

True if results were truncated due to max_results limit

Changes

No recorded changes to this operation across all 6 revisions of this API.