# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Agent OS Parallel Work Graphs API version: 1.0.0 extends: openapi/agoragentic-com-agent-os-parallel-work-graphs-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 9 - target: $.paths['/agent-os/parallel/graphs'].post update: x-apievangelist-phrasing: intent: Plan a parallel work graph effect: write questions: - How do I split a goal into parallel branches for my Agent OS deployment? - Can I set a budget and merge strategy when planning a parallel work graph? instructions: - text: Plan a parallel work graph on deployment {deployment_id} for goal {goal} with branches {branches}. slots: deployment_id: requestBody.deployment_id goal: requestBody.goal branches: requestBody.branches - text: Create a work graph for {goal} on {deployment_id} with branches {branches}, budget {budget}, merged by {merge_strategy}. slots: goal: requestBody.goal deployment_id: requestBody.deployment_id branches: requestBody.branches budget: requestBody.budget merge_strategy: requestBody.merge_strategy method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}'].get update: x-apievangelist-phrasing: intent: Get a work graph with its attempt audit effect: read questions: - What's the current state of my parallel work graph, including its branches and cost? - Can I see the budget attempts recorded for a work graph? instructions: - text: Show parallel work graph {id}. slots: id: path.id - text: Get graph {id} with its branches, cost summary and budget attempts. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/cancel'].post update: x-apievangelist-phrasing: intent: Cancel a parallel work graph effect: destructive questions: - How do I stop a parallel work graph and all its running branches? - What happens to in-flight workers when I cancel a graph? instructions: - text: Cancel work graph {id}. slots: id: path.id - text: Durably cancel graph {id} and abort its branches. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/retry'].post update: x-apievangelist-phrasing: intent: Retry failed branches via the legacy alias effect: write questions: - My older client calls the retry alias; does it still requeue failed branches of a graph? - Is the plain retry route the same as retry-failed? instructions: - text: Retry graph {id} using the older retry compatibility route. slots: id: path.id - text: Call the legacy retry alias on graph {id} with force set to {force}. slots: id: path.id force: requestBody.force method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/retry-failed'].post update: x-apievangelist-phrasing: intent: Retry a graph's failed branches effect: write questions: - How do I rerun only the branches that failed in my parallel work graph? - Does retrying failed branches reuse the previous attempt or create a new one? instructions: - text: Retry the failed branches of graph {id}. slots: id: path.id - text: 'Requeue failed branches in work graph {id}, forcing it: {force}.' slots: id: path.id force: requestBody.force method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/execute'].post update: x-apievangelist-phrasing: intent: Revalidate or canary-run a work graph effect: write questions: - How do I execute a queued parallel work graph, or run its no-effect canary? - Why is ordinary marketplace dispatch unavailable when I execute a graph? instructions: - text: Execute work graph {id}. slots: id: path.id - text: Revalidate the authority of queued graph {id} and run its canary. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/receipts'].get update: x-apievangelist-phrasing: intent: Get a work graph's receipts effect: read questions: - Which attempts in my work graph produced receipts, and what did they cost? - Where can I reconcile a parallel graph's receipts and settlement status? instructions: - text: Show the receipts for graph {id}. slots: id: path.id - text: List receipt-bearing attempts and cost completeness for work graph {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/graphs/{id}/branches'].get update: x-apievangelist-phrasing: intent: List a work graph's branches effect: read questions: - What branches make up my parallel work graph? - How do I see every branch and its status for one graph? instructions: - text: List the branches of graph {id}. slots: id: path.id - text: Show all branches in parallel work graph {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/agent-os/parallel/branches/{id}'].get update: x-apievangelist-phrasing: intent: Get one work graph branch effect: read questions: - How do I inspect a single branch of a parallel work graph by its own ID? - Why does a branch lookup return 404 when I'm not authorized for its graph? instructions: - text: Show branch {id}. slots: id: path.id - text: Get the status and output of parallel work branch {id}. slots: id: path.id method: generated generated: '2026-09-26'