List user-accessible AI agents and system agents

GET 
/ai/agents

Returns AI agents the caller can access (owner, editor, or read-only), plus system agents that are always included. Listing is in-memory: results are filtered, sorted, and paginated in the Lambda. Caller must send a valid role_id. Requires AICore to be enabled (AI-1004 otherwise). Pagination: check next_available in the response. When "yes", more pages exist; increment offset (1-based). When "next_available" is "no", you have reached the last page. Default limit is 25; maximum is 1000 (IPV-1050 if exceeded). Default sort is LastModifiedTime descending. Query action=upload-script is a creation-only shortcut. It does not list agents. It returns a PUT presigned URL and a new AgentId. Upload the agent package zip to that URL, then POST /ai/agents with the same AgentId.

Request

Responses

200

Successful response. (1) No action: paginated ListAgentsResponse with agents, count, total_count, and next_available. (2) action=upload-script: CreateAgentPackageUploadResponse with Message, PresignedUrl, and AgentId.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. IPV-1006 invalid projectionExpression keys. IPV-1050 when limit exceeds 1000. AUTH-1001 missing role_id. AUTH-* when the role cannot call this API. AI-1004 when AICore is not enabled.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. GE-1044 for unexpected errors.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers