# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Netlify's API documentation Agent Runner API version: 1.0.0 extends: openapi/netlify-agentrunner-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_runners'].get update: x-apievangelist-phrasing: intent: List agent runs for a site effect: read questions: - Which AI agent runs have been started on my site? - Can I filter agent runs by state or branch? - How do I find agent runs from a certain date range? instructions: - text: List agent runs for site {site} in account {account}. slots: site: query.site_id account: query.account_id - text: Show agent runs on site {site} in account {account} that are in state {state}. slots: site: query.site_id account: query.account_id state: query.state - text: List agent runs for site {site}, account {account}, on branch {branch}. slots: site: query.site_id account: query.account_id branch: query.branch method: generated generated: '2026-09-26' - target: $.paths['/agent_runners'].post update: x-apievangelist-phrasing: intent: Start an AI agent run on a site effect: write questions: - How do I kick off an AI agent to make changes to my Netlify site? - Can I choose which agent and model runs the task? instructions: - text: Start an agent run on site {site} with the prompt {prompt}. slots: site: query.site_id prompt: query.prompt - text: Run agent {agent} using model {model} on branch {branch} of site {site} with prompt {prompt}. slots: agent: query.agent model: query.model branch: query.branch site: query.site_id prompt: query.prompt method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/upload_url'].post update: x-apievangelist-phrasing: intent: Get an upload URL for an agent run file effect: write questions: - Can I attach a file for an agent run to use? - Where do I upload images or files before starting an agent run? instructions: - text: Get an upload URL in account {account} for file {filename} of type {content_type}. slots: account: query.account_id filename: query.filename content_type: query.content_type - text: Create a signed upload link for {filename} ({content_type}) for agent runs in account {account}. slots: filename: query.filename content_type: query.content_type account: query.account_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}'].get update: x-apievangelist-phrasing: intent: Get an agent run effect: read questions: - What is the status of my agent run? - Can I see the details of a single agent run? instructions: - text: Get agent run {runner}. slots: runner: path.agent_runner_id - text: Check the progress of agent run {runner}. slots: runner: path.agent_runner_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}'].delete update: x-apievangelist-phrasing: intent: Delete an agent run effect: destructive questions: - How do I delete an agent run I don't need? - Can I permanently remove an agent run? instructions: - text: Delete agent run {runner}. slots: runner: path.agent_runner_id - text: Permanently remove agent run {runner}. slots: runner: path.agent_runner_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}'].patch update: x-apievangelist-phrasing: intent: Update an agent run effect: write questions: - Can I change an agent run after it's been created? - Is it possible to edit an existing agent run? instructions: - text: Update agent run {runner}. slots: runner: path.agent_runner_id - text: Modify the settings of agent run {runner}. slots: runner: path.agent_runner_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}/archive'].post update: x-apievangelist-phrasing: intent: Archive an agent run effect: write questions: - How do I archive an agent run without deleting it? - Can I hide finished agent runs by archiving them? instructions: - text: Archive agent run {runner}. slots: runner: path.agent_runner_id - text: Move agent run {runner} to the archive. slots: runner: path.agent_runner_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}/pull_request'].post update: x-apievangelist-phrasing: intent: Open a pull request from an agent run effect: write questions: - Can an agent run open a pull request with its changes? - How do I turn an agent's changes into a PR for review? instructions: - text: Open a pull request from agent run {runner}. slots: runner: path.agent_runner_id - text: Create a PR with the changes made by agent run {runner}. slots: runner: path.agent_runner_id method: generated generated: '2026-09-26' - target: $.paths['/agent_runners/{agent_runner_id}/commit'].post update: x-apievangelist-phrasing: intent: Commit agent run changes to a branch effect: write questions: - Can I commit an agent run's changes straight to a branch? - Which branch receives the commit from an agent run? instructions: - text: Commit the changes from agent run {runner} to branch {branch}. slots: runner: path.agent_runner_id branch: query.target_branch - text: Push agent run {runner}'s work directly onto {branch}. slots: runner: path.agent_runner_id branch: query.target_branch method: generated generated: '2026-09-26'