IntegrationOS

IntegrationOS AI Runners API

Manage AI agent runner pods

GitHub OpenAPI

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id} Tear down a project agent's runner · Destroy project ai runner #
Ask an LLM
“How do I shut down and remove the runner for a project-scoped agent?”
“Does destroying a project agent's runner keep the agent itself?”
Tell an agent destructive · confirm first
Destroy the runner for agent {agent_id} in project {project_id} of organization {org_id}.
Tear down project agent {agent_id}'s hosted runtime in project {project_id}, org {org_id}.
GET /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id} Check a project agent's runner status · Get project ai runner status #
Ask an LLM
“Is the runner behind my project-scoped AI agent up right now?”
“Where can I see whether a project agent's hosted runtime is running?”
Tell an agent
Check the runner status for agent {agent_id} in project {project_id} of organization {org_id}.
Tell me if the project agent {agent_id}'s runner is alive in project {project_id}, org {org_id}.
POST /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id} Start a project agent's runner if not running · Ensure project ai runner #
Ask an LLM
“Can I make sure a project agent has a runner spun up before I send it work?”
“What brings a stopped runner for a project-scoped agent back online?”
Tell an agent
Ensure a runner is up for agent {agent_id} in project {project_id} of organization {org_id}.
Spin up the project runner for agent {agent_id} under project {project_id}, org {org_id}, if it is not already running.
GET /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id}/dashboard-password Reveal a project runner's dashboard password · Reveal project ai runner dashboard password #
Ask an LLM
“Where do I find the dashboard password for a project agent's runner?”
“Can I look up the current runner dashboard login for an agent inside a project?”
Tell an agent
Show the runner dashboard password for agent {agent_id} in project {project_id}, org {org_id}.
Reveal project {project_id}'s runner dashboard password for agent {agent_id} in organization {org_id}.
POST /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id}/dashboard-password/regenerate Rotate a project runner's dashboard password · Regenerate project ai runner dashboard password #
Ask an LLM
“How can I rotate the runner dashboard password for a project-scoped agent?”
“If a project agent's dashboard password leaked, can I generate a new one?”
Tell an agent
Regenerate the runner dashboard password for agent {agent_id} in project {project_id}, org {org_id}.
Issue a fresh dashboard password for project {project_id}'s agent runner {agent_id} in organization {org_id}.
POST /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id}/proxy/{path} Forward a request to a project agent's runner · Proxy project ai runner #
Ask an LLM
“Can I send a request straight through to a project agent's runner?”
“How do I call an endpoint on the runtime hosting a project-scoped agent?”
Tell an agent
Proxy a request to path {path} on agent {agent_id}'s runner in project {project_id}, org {org_id}.
Forward a call to {path} on the project runner for agent {agent_id} under project {project_id} in organization {org_id}.
DELETE /v1/ai-runners/organizations/{org_id}/{agent_id} Tear down an organization agent's runner · Destroy org ai runner #
Ask an LLM
“How do I remove the runner hosting an organization-scoped agent?”
“Can I stop an org agent's runtime without deleting the agent?”
Tell an agent destructive · confirm first
Destroy the runner for organization agent {agent_id} in org {org_id}.
Shut down org {org_id}'s runner for agent {agent_id}.
GET /v1/ai-runners/organizations/{org_id}/{agent_id} Check an organization agent's runner status · Get org ai runner status #
Ask an LLM
“Is the runner for an organization-scoped AI agent currently running?”
“What state is my org agent's hosted runtime in?”
Tell an agent
Check the runner status for organization agent {agent_id} in org {org_id}.
Tell me whether org {org_id}'s agent {agent_id} has a live runner.
POST /v1/ai-runners/organizations/{org_id}/{agent_id} Start an organization agent's runner · Ensure org ai runner #
Ask an LLM
“Can I make sure an organization-level agent's runner is spun up?”
“What restarts the hosted runtime for an org-scoped agent that went down?”
Tell an agent
Ensure a runner is running for organization agent {agent_id} in org {org_id}.
Bring up the org-level runner for agent {agent_id} in organization {org_id}.
GET /v1/ai-runners/organizations/{org_id}/{agent_id}/dashboard-password Reveal an org runner's dashboard password · Reveal org ai runner dashboard password #
Ask an LLM
“Where is the dashboard password for an organization agent's runner?”
“Can I retrieve the login for an org-scoped agent's runner dashboard?”
Tell an agent
Show the runner dashboard password for organization agent {agent_id} in org {org_id}.
Reveal org {org_id}'s runner dashboard login for agent {agent_id}.
POST /v1/ai-runners/organizations/{org_id}/{agent_id}/dashboard-password/regenerate Rotate an org runner's dashboard password · Regenerate org ai runner dashboard password #
Ask an LLM
“How do I rotate the runner dashboard password for an organization agent?”
“Can I invalidate an org agent's old dashboard password and get a new one?”
Tell an agent
Regenerate the runner dashboard password for organization agent {agent_id} in org {org_id}.
Rotate org {org_id}'s dashboard password for the runner of agent {agent_id}.
POST /v1/ai-runners/organizations/{org_id}/{agent_id}/proxy/{path} Forward a request to an org agent's runner · Proxy org ai runner #
Ask an LLM
“Can I pass a request through to the runner behind an organization agent?”
“How do I reach a specific path on an org-scoped agent's runtime?”
Tell an agent
Proxy a request to path {path} on organization agent {agent_id}'s runner in org {org_id}.
Send a call to {path} through org {org_id}'s runner for agent {agent_id}.
DELETE /v1/ai-runners/{agent_id} Tear down my agent's runner · Destroy ai runner #
Ask an LLM
“How do I destroy the runner hosting my personal agent?”
“Can I free up my own agent's runtime without removing the agent?”
Tell an agent destructive · confirm first
Destroy the runner for my agent {agent_id}.
Tear down the personal-scope runtime for agent {agent_id}.
GET /v1/ai-runners/{agent_id} Check my agent's runner status · Get ai runner status #
Ask an LLM
“Is the runner for my personal AI agent up?”
“How can I tell if my own agent's hosted runtime is running in One?”
Tell an agent
Check the runner status for my agent {agent_id}.
Tell me if agent {agent_id} in my personal scope has a running runner.
POST /v1/ai-runners/{agent_id} Start my agent's runner if needed · Ensure ai runner #
Ask an LLM
“Can I make sure my personal agent has a runner before calling it?”
“What do I call to bring my own agent's runtime back up?”
Tell an agent
Ensure a runner is up for my agent {agent_id}.
Start the personal runner for agent {agent_id} if it is stopped.
GET /v1/ai-runners/{agent_id}/dashboard-password Reveal my agent runner's dashboard password · Reveal ai runner dashboard password #
Ask an LLM
“Where do I get the dashboard password for my personal agent's runner?”
“What is the login for my own agent's runner dashboard?”
Tell an agent
Show the runner dashboard password for my agent {agent_id}.
Reveal the personal runner dashboard login for agent {agent_id}.
POST /v1/ai-runners/{agent_id}/dashboard-password/regenerate Rotate my agent runner's dashboard password · Regenerate ai runner dashboard password #
Ask an LLM
“How can I rotate the dashboard password on my personal agent's runner?”
“Can I generate a replacement runner dashboard password for my own agent?”
Tell an agent
Regenerate the runner dashboard password for my agent {agent_id}.
Rotate the personal dashboard password for agent {agent_id}'s runner.
POST /v1/ai-runners/{agent_id}/proxy/{path} Forward a request to my agent's runner · Proxy ai runner #
Ask an LLM
“Can I proxy a request through to my personal agent's runner?”
“How do I hit an endpoint on the runtime that hosts my own agent?”
Tell an agent
Proxy a request to path {path} on my agent {agent_id}'s runner.
Forward a call to {path} on the personal runner for agent {agent_id}.

Documentation

📖
APIReference
https://www.withone.ai/docs/api-reference/introduction
📖
GettingStarted
https://www.withone.ai/docs/getting-started
📖
Documentation
https://www.withone.ai/docs/welcome

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/openapi/integration-os-ai-runners-api-openapi.yml

Other Resources

🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/mcp/integration-os-tool-crosswalk.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/asyncapi/integration-os-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/errors/integration-os-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/data-model/integration-os-data-model.yml
🔗
Portal
https://withone.ai
🔗
Blog
https://www.withone.ai/blog
🔗
KnowledgeBase
https://www.withone.ai/knowledge
🔗
Signup
https://app.withone.ai
🔗
Login
https://app.withone.ai
🔗
GitHubOrg
https://github.com/withoneai
🔗
GitHubRepo
https://github.com/withoneai/knowledge
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/rules/integration-os-rules.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/integration-os:integration-os-ai-runners-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

integration-os-ai-runners-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: The One API. Universal API integration platform for AI agents and applications.
  license:
    name: ''
  title: One AI Runners API
  version: 5.35.0
tags:


# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/openapi/integration-os-ai-runners-api-openapi.yml