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.
View Overlay File View on GitHub Overlay Specification

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

Raw ↑
# 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.
All 92 tools →

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.