Digital Ocean · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for DigitalOcean Agents API
55 actions
55 updates
phrasing
extends
openapi/digital-ocean-agents-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Digital Ocean's API. It is a proposal applied on top of the contract, not a document Digital Ocean publishes.
What the actions change
x-apievangelist-phrasing
Targets 55 · first 16 shown; the file carries all of them
$.info
$.paths['/v2/agents/configs'].get
$.paths['/v2/agents/configs'].post
$.paths['/v2/agents/configs/{config_id}'].get
$.paths['/v2/agents/configs/{config_id}'].delete
$.paths['/v2/agents/configs/{config_id}/clone'].post
$.paths['/v2/agents/configs/{config_id}/sessions'].get
$.paths['/v2/agents/sessions'].get
$.paths['/v2/agents/sessions'].post
$.paths['/v2/agents/sessions/policy/validate'].post
$.paths['/v2/agents/sessions/sandbox/sizes'].get
$.paths['/v2/agents/sessions/{session_id}'].get
$.paths['/v2/agents/sessions/{session_id}'].delete
$.paths['/v2/agents/sessions/{session_id}'].patch
$.paths['/v2/agents/sessions/{session_id}/checkpoints'].get
$.paths['/v2/agents/sessions/{session_id}/checkpoints'].post
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for DigitalOcean Agents API
version: 1.0.0
extends: openapi/digital-ocean-agents-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-11-18'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 54
- target: $.paths['/v2/agents/configs'].get
update:
x-apievangelist-phrasing:
intent: List agent configuration templates
effect: read
questions:
- What agent configuration templates are available for my AI agents?
- Can I see all agent config templates at once?
instructions:
- text: List all agent configuration templates.
- text: Show every agent config template.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/configs'].post
update:
x-apievangelist-phrasing:
intent: Create an agent configuration template
effect: write
questions:
- How do I create a reusable template for my AI agents?
- Can I define a new agent config template?
instructions:
- text: Create a new agent configuration template.
- text: Add a new agent config template.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/configs/{config_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an agent configuration template
effect: read
questions:
- What does one agent config template contain?
- Can I fetch a single agent config template by its ID?
instructions:
- text: Get agent config template {config_id}.
slots:
config_id: path.config_id
- text: Show the details of agent config template {config_id}.
slots:
config_id: path.config_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/configs/{config_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an agent configuration template
effect: destructive
questions:
- How do I remove an agent config template I no longer use?
- Can I delete an agent config template by its ID?
instructions:
- text: Delete agent config template {config_id}.
slots:
config_id: path.config_id
- text: Remove the agent config template {config_id}.
slots:
config_id: path.config_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/configs/{config_id}/clone'].post
update:
x-apievangelist-phrasing:
intent: Clone an agent configuration template
effect: write
questions:
- Can I duplicate an existing agent config template?
- How do I create a copy of an agent config template?
instructions:
- text: Clone agent config template {config_id}.
slots:
config_id: path.config_id
- text: Duplicate the agent config template {config_id}.
slots:
config_id: path.config_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/configs/{config_id}/sessions'].get
update:
x-apievangelist-phrasing:
intent: List sessions using an agent config template
effect: read
questions:
- Which agent sessions are using a particular config template?
- Can I see the sessions built on one agent config template?
instructions:
- text: List sessions using agent config template {config_id}.
slots:
config_id: path.config_id
- text: Show the sessions that rely on agent config template {config_id}.
slots:
config_id: path.config_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions'].get
update:
x-apievangelist-phrasing:
intent: List agent sessions
effect: read
questions:
- What agent sessions have been run?
- Can I see all my agent sessions?
instructions:
- text: List all agent sessions.
- text: Show every agent session.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions'].post
update:
x-apievangelist-phrasing:
intent: Start a new agent session
effect: write
questions:
- How do I start a new agent session?
- Can I create an agent session from a config template?
instructions:
- text: Start a new agent session.
- text: Create an agent session.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/policy/validate'].post
update:
x-apievangelist-phrasing:
intent: Validate an agent session policy
effect: read
questions:
- Can I check an agent session policy before starting a session?
- Is there a way to validate an agent session policy?
instructions:
- text: Validate the agent session policy.
- text: Check an agent session policy.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/sandbox/sizes'].get
update:
x-apievangelist-phrasing:
intent: List sandbox sizes for agent sessions
effect: read
questions:
- What sandbox sizes can agent sessions use?
- Which sandbox sizes are available for agent sessions?
instructions:
- text: List sandbox sizes for agent sessions.
- text: Show the available agent session sandbox sizes.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an agent session
effect: read
questions:
- What happened in a specific agent session?
- Can I fetch one agent session by its ID?
instructions:
- text: Get agent session {session_id}.
slots:
session_id: path.session_id
- text: Show the details of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an agent session
effect: destructive
questions:
- How do I delete an agent session?
- Can I remove an agent session by its ID?
instructions:
- text: Delete agent session {session_id}.
slots:
session_id: path.session_id
- text: Remove the agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}'].patch
update:
x-apievangelist-phrasing:
intent: Update an agent session
effect: write
questions:
- Can I edit an existing agent session?
- How do I change an agent session's settings?
instructions:
- text: Update agent session {session_id}.
slots:
session_id: path.session_id
- text: Edit the settings of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/checkpoints'].get
update:
x-apievangelist-phrasing:
intent: List checkpoints in an agent session
effect: read
questions:
- What checkpoints exist in an agent session?
- Can I see the saved checkpoints of one agent session?
instructions:
- text: List checkpoints in agent session {session_id}.
slots:
session_id: path.session_id
- text: Show the saved checkpoints of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/checkpoints'].post
update:
x-apievangelist-phrasing:
intent: Save a checkpoint in an agent session
effect: write
questions:
- How do I save a checkpoint in an agent session?
- Can I pause an agent session and save its state?
instructions:
- text: Save a checkpoint in agent session {session_id}.
slots:
session_id: path.session_id
- text: Pause agent session {session_id} and save its state.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/checkpoints/{checkpoint_id}'].get
update:
x-apievangelist-phrasing:
intent: Get a code agent session checkpoint
effect: read
questions:
- What is the state of an agent session at a specific checkpoint?
- Can I read one step's output from a code agent session?
instructions:
- text: Get checkpoint {checkpoint_id} of agent session {session_id}.
slots:
checkpoint_id: path.checkpoint_id
session_id: path.session_id
- text: Show the status of agent session {session_id} at checkpoint {checkpoint_id}.
slots:
session_id: path.session_id
checkpoint_id: path.checkpoint_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/checkpoints/{checkpoint_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an agent session checkpoint
effect: destructive
questions:
- How do I remove a checkpoint from an agent session?
- Can I delete an agent session checkpoint by its ID?
instructions:
- text: Delete checkpoint {checkpoint_id} from agent session {session_id}.
slots:
checkpoint_id: path.checkpoint_id
session_id: path.session_id
- text: Remove agent session {session_id} checkpoint {checkpoint_id}.
slots:
session_id: path.session_id
checkpoint_id: path.checkpoint_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/checkpoints/{checkpoint_id}/rollback'].post
update:
x-apievangelist-phrasing:
intent: Roll back an agent session to a checkpoint
effect: write
questions:
- Can I revert an agent session to a previous checkpoint?
- How do I undo changes in an agent session by rolling back?
instructions:
- text: Roll back agent session {session_id} to checkpoint {checkpoint_id}.
slots:
session_id: path.session_id
checkpoint_id: path.checkpoint_id
- text: Undo to checkpoint {checkpoint_id} in agent session {session_id}.
slots:
checkpoint_id: path.checkpoint_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/fork'].post
update:
x-apievangelist-phrasing:
intent: Fork an agent session
effect: write
questions:
- How do I create a copy of an agent session?
- Can I fork an existing agent session?
instructions:
- text: Fork agent session {session_id}.
slots:
session_id: path.session_id
- text: Create a copy of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/hitl/{request_id}'].post
update:
x-apievangelist-phrasing:
intent: Send an agent session request to human-in-the-loop
effect: write
questions:
- Can I hand an agent session over to a human for review?
- How do I ask a human to review a specific agent session request?
instructions:
- text: Send request {request_id} from agent session {session_id} to human-in-the-loop.
slots:
request_id: path.request_id
session_id: path.session_id
- text: Ask a human to review request {request_id} in agent session {session_id}.
slots:
request_id: path.request_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/input'].post
update:
x-apievangelist-phrasing:
intent: Send input to an agent session
effect: write
questions:
- How do I send a prompt to an agent session?
- Can I feed an agent session a new input while it's running?
instructions:
- text: Send this input to agent session {session_id}.
slots:
session_id: path.session_id
- text: Feed a new prompt to agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/pause'].post
update:
x-apievangelist-phrasing:
intent: Pause an agent session
effect: write
questions:
- How do I pause an agent session?
- Can I temporarily stop an agent session without closing it?
instructions:
- text: Pause agent session {session_id}.
slots:
session_id: path.session_id
- text: Temporarily stop agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/resume'].post
update:
x-apievangelist-phrasing:
intent: Resume a paused agent session
effect: write
questions:
- How do I resume a paused agent session?
- Can I restart an agent session after pausing it?
instructions:
- text: Resume agent session {session_id}.
slots:
session_id: path.session_id
- text: Restart the paused agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/sandbox/exec'].post
update:
x-apievangelist-phrasing:
intent: Run a command in an agent session's sandbox
effect: write
questions:
- How do I run a command inside an agent session's sandbox?
- Can an agent session execute code in its isolated environment?
instructions:
- text: Run this command in the sandbox of agent session {session_id}.
slots:
session_id: path.session_id
- text: Execute a command in agent session {session_id}'s sandbox.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/download'].get
update:
x-apievangelist-phrasing:
intent: Download an agent session's workspace
effect: read
questions:
- How do I download the workspace of an agent session?
- Can I export everything an agent session worked on?
instructions:
- text: Download the workspace of agent session {session_id}.
slots:
session_id: path.session_id
- text: Export everything agent session {session_id} worked on.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/transfers'].post
update:
x-apievangelist-phrasing:
intent: Transfer files to an agent session's workspace
effect: write
questions:
- How do I transfer files into an agent session's workspace?
- Can I upload files to an agent session's workspace?
instructions:
- text: Transfer files into agent session {session_id}'s workspace.
slots:
session_id: path.session_id
- text: Upload files to the workspace of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/transfers/{transfer_id}'].get
update:
x-apievangelist-phrasing:
intent: Check a file transfer to an agent session
effect: read
questions:
- Has a file transfer to an agent session finished?
- What is the status of a file transfer in an agent session?
instructions:
- text: Check file transfer {transfer_id} in agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
- text: Get the status of transfer {transfer_id} to agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/transfers/{transfer_id}/cancel'].post
update:
x-apievangelist-phrasing:
intent: Cancel a file transfer to an agent session
effect: destructive
questions:
- How do I cancel a file transfer to an agent session?
- Can I stop a file transfer that is still in progress?
instructions:
- text: Cancel file transfer {transfer_id} to agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
- text: Stop the in-progress transfer {transfer_id} into agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/transfers/{transfer_id}/commit'].post
update:
x-apievangelist-phrasing:
intent: Commit a file transfer to an agent session
effect: write
questions:
- How do I commit a file transfer into an agent session's workspace?
- Can I finalize a transfer so the files are saved?
instructions:
- text: Commit file transfer {transfer_id} into agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
- text: Finalize transfer {transfer_id} into agent session {session_id}'s workspace.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/transfers/{transfer_id}/part-upload-urls'].post
update:
x-apievangelist-phrasing:
intent: Get upload URLs for a file transfer part
effect: read
questions:
- How do I get upload URLs for a part of a file transfer?
- Can I upload a file transfer part in chunks?
instructions:
- text: Get upload URLs for part of transfer {transfer_id} in agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
- text: Generate chunk upload URLs for transfer {transfer_id} to agent session {session_id}.
slots:
transfer_id: path.transfer_id
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/workspace/upload'].post
update:
x-apievangelist-phrasing:
intent: Upload a file to an agent session's workspace
effect: write
questions:
- How do I upload a file into an agent session's workspace?
- Can I add a file to an agent session's workspace?
instructions:
- text: Upload a file into agent session {session_id}'s workspace.
slots:
session_id: path.session_id
- text: Add a file to the workspace of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/events'].get
update:
x-apievangelist-phrasing:
intent: List events of an agent session
effect: read
questions:
- What events have happened in an agent session?
- Can I see the event log of an agent session?
instructions:
- text: List events for agent session {session_id}.
slots:
session_id: path.session_id
- text: Show the event log of agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/port-forward/{port}'].get
update:
x-apievangelist-phrasing:
intent: Forward a port from an agent session
effect: read
questions:
- How do I forward a port from an agent session?
- Can I access a port on an agent session from my machine?
instructions:
- text: Forward port {port} from agent session {session_id}.
slots:
port: path.port
session_id: path.session_id
- text: Expose port {port} of agent session {session_id} to my machine.
slots:
port: path.port
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/sessions/{session_id}/ingress'].get
update:
x-apievangelist-phrasing:
intent: Get an agent session's ingress URL
effect: read
questions:
- What URL can I use to reach an agent session?
- Where do I find the ingress address of an agent session?
instructions:
- text: Get the ingress URL for agent session {session_id}.
slots:
session_id: path.session_id
- text: Show how to reach agent session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates'].get
update:
x-apievangelist-phrasing:
intent: List agent templates
effect: read
questions:
- What agent templates are available?
- Can I see the agent templates I can use?
instructions:
- text: List agent templates.
- text: Show the available agent templates.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates'].post
update:
x-apievangelist-phrasing:
intent: Create an agent template
effect: write
questions:
- How do I create a new agent template?
- Can I define a reusable agent template?
instructions:
- text: Create an agent template.
- text: Define a new reusable agent template.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates/{template_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an agent template
effect: read
questions:
- What does a particular agent template contain?
- Can I read one agent template by its ID?
instructions:
- text: Get agent template {template_id}.
slots:
template_id: path.template_id
- text: Show the contents of agent template {template_id}.
slots:
template_id: path.template_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates/{template_id}'].put
update:
x-apievangelist-phrasing:
intent: Replace an agent template
effect: write
questions:
- How do I replace an existing agent template?
- Can I overwrite an agent template's definition?
instructions:
- text: Replace agent template {template_id}.
slots:
template_id: path.template_id
- text: Overwrite the definition of agent template {template_id}.
slots:
template_id: path.template_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates/{template_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an agent template
effect: destructive
questions:
- How do I delete an agent template?
- Can I remove an agent template I no longer use?
instructions:
- text: Delete agent template {template_id}.
slots:
template_id: path.template_id
- text: Remove agent template {template_id}.
slots:
template_id: path.template_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates/{template_id}/builds'].get
update:
x-apievangelist-phrasing:
intent: List builds of an agent template
effect: read
questions:
- What builds have been made from an agent template?
- Can I see the build history of an agent template?
instructions:
- text: List builds of agent template {template_id}.
slots:
template_id: path.template_id
- text: Show the build history for agent template {template_id}.
slots:
template_id: path.template_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/templates/{template_id}/builds/{build_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an agent template build
effect: read
questions:
- What is the status of a specific build of an agent template?
- Can I fetch one agent template build by its template and build IDs?
instructions:
- text: Get build {build_id} of agent template {template_id}.
slots:
build_id: path.build_id
template_id: path.template_id
- text: Show the status of template {template_id} build {build_id}.
slots:
template_id: path.template_id
build_id: path.build_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers'].get
update:
x-apievangelist-phrasing:
intent: List agent triggers
effect: read
questions:
- Which agent triggers are configured on my account?
- Can I see all agent triggers and their settings?
instructions:
- text: List all agent triggers.
- text: Show every agent trigger configured.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers'].post
update:
x-apievangelist-phrasing:
intent: Create an agent trigger
effect: write
questions:
- How do I create a new trigger that runs an agent?
- Can I add a trigger that starts an agent on a schedule?
instructions:
- text: Create a new agent trigger.
- text: Add a trigger that runs an agent.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/by-session/{session_id}'].get
update:
x-apievangelist-phrasing:
intent: Get agent triggers by session
effect: read
questions:
- Can I look up agent triggers that belong to a particular session?
- What triggers are attached to a given session ID?
instructions:
- text: Get agent triggers for session {session_id}.
slots:
session_id: path.session_id
- text: Show the triggers tied to session {session_id}.
slots:
session_id: path.session_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/reusable-sessions'].get
update:
x-apievangelist-phrasing:
intent: List reusable agent trigger sessions
effect: read
questions:
- Which reusable sessions can I use for agent triggers?
- What reusable sessions exist for agent triggers?
instructions:
- text: List reusable sessions for agent triggers.
- text: Show the reusable sessions available to agent triggers.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an agent trigger
effect: read
questions:
- Can I read one agent trigger's settings?
- What does a specific agent trigger look like?
instructions:
- text: Get agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Show the settings of trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an agent trigger
effect: destructive
questions:
- How do I remove an agent trigger?
- Can I delete a trigger that runs an agent?
instructions:
- text: Delete agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Remove trigger {trigger_id} from my account.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}'].patch
update:
x-apievangelist-phrasing:
intent: Update an agent trigger
effect: write
questions:
- Can I change the settings of an existing agent trigger?
- How do I edit an agent trigger I already created?
instructions:
- text: Update agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Change the settings of trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}/executions'].get
update:
x-apievangelist-phrasing:
intent: List executions of an agent trigger
effect: read
questions:
- What has an agent trigger run so far?
- Can I see the execution history of one trigger?
instructions:
- text: List executions of agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Show every run of trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}/executions/{execution_id}'].get
update:
x-apievangelist-phrasing:
intent: Get a code agent trigger execution
effect: read
questions:
- Did a code agent trigger successfully run?
- Where do I see the logs of one code agent execution?
instructions:
- text: Get execution {execution_id} of trigger {trigger_id}.
slots:
execution_id: path.execution_id
trigger_id: path.trigger_id
- text: Show the results of code agent trigger {trigger_id}'s run {execution_id}.
slots:
trigger_id: path.trigger_id
execution_id: path.execution_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}/executions/{execution_id}/cancel'].post
update:
x-apievangelist-phrasing:
intent: Cancel an agent trigger execution
effect: destructive
questions:
- Can I stop an agent trigger that is still running?
- How do I cancel a running execution of a trigger?
instructions:
- text: Cancel execution {execution_id} of agent trigger {trigger_id}.
slots:
execution_id: path.execution_id
trigger_id: path.trigger_id
- text: Stop the running run {execution_id} of trigger {trigger_id}.
slots:
execution_id: path.execution_id
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}/rotate-secret'].post
update:
x-apievangelist-phrasing:
intent: Rotate a trigger's secret
effect: destructive
questions:
- Can I rotate the secret used by an agent trigger?
- How do I rotate a trigger's secret without recreating it?
instructions:
- text: Rotate the secret of agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Issue a new secret for trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/agents/triggers/{trigger_id}/webhook'].post
update:
x-apievangelist-phrasing:
intent: Send a webhook to an agent trigger
effect: write
questions:
- Can I fire a webhook at an agent trigger?
- How do I send a webhook to a trigger so it runs?
instructions:
- text: Send a webhook to agent trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
- text: Fire a webhook at trigger {trigger_id}.
slots:
trigger_id: path.trigger_id
method: generated
generated: '2026-11-18'
# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/digital-ocean/overlays/digital-ocean-agents-api-phrasing-overlay.yaml
Work with this as data
Every overlay here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/digital-ocean-agents-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.