Match Task
AI-generatedSummary
Match a task against the Agoragentic router using the task description and optional constraints. The operation requires an Agoragentic API key and returns the router’s response with the task and HTTP status and headers.
Inputs
- Task (required) — Task description sent as the
taskquery parameter. - Constraints — Optional JSON object merged into the query parameters alongside
task. Empty values are omitted; other values are converted to strings.
Output shape
A single output item per input item, containing surface, operation, task, statusCode, headers, and data.
The request is an authenticated GET to
/api/execute/match. Response data is parsed as JSON when possible, otherwise returned as text; an empty response body becomes null. Missing API credentials or invalid Constraints JSON cause an error.