IntegrationOS

IntegrationOS AI Agents API

Manage AI agents for automation and orchestration

GitHub OpenAPI
Business capability
Artificial Intelligence Management BC-610.60

Operations 15

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

GET /v1/ai-agents List my AI agents · List AI agents #
Ask an LLM
“Which AI agents do I have in my account?”
“Why don't my test agents show up when I use a live key?”
Tell an agent
List my AI agents.
Show {limit} of my personal agents on page {page}.
POST /v1/ai-agents Create an AI agent · Create AI agent #
Ask an LLM
“How do I create an AI agent in my own account with a chosen model and skills?”
“Can a new agent have guardrails, triggers and memory set at creation?”
Tell an agent
Create a personal agent named {name} on model {model} with tools {tools}.
Make an agent {name} using {model}, skills {tools}, that wakes on triggers {triggers}.
GET /v1/ai-agents/organizations/{org_id} List an organization's AI agents · List organization AI agents #
Ask an LLM
“What AI agents does my organization own?”
“Can I page through org-level agents shared across projects?”
Tell an agent
List AI agents owned by organization {org_id}.
Show page {page} of org {org_id}'s agents.
POST /v1/ai-agents/organizations/{org_id} Create an organization AI agent · Create organization AI agent #
Ask an LLM
“How do I create an agent that every project in my organization can see?”
“Does creating an org agent count against my organization's plan quota?”
Tell an agent
Create organization agent {name} in org {org_id} on model {model} with tools {tools}.
Add an org-wide agent {name} to {org_id} using {model}, skills {tools}, channels {channels}.
GET /v1/ai-agents/organizations/{org_id}/projects/{project_id} List a project's AI agents · List project AI agents #
Ask an LLM
“Which AI agents live inside a specific project?”
“Can I list only the agents scoped to one project?”
Tell an agent
List AI agents in project {project_id} of organization {org_id}.
Show {limit} project agents per page for project {project_id}, org {org_id}.
POST /v1/ai-agents/organizations/{org_id}/projects/{project_id} Create a project AI agent · Create project AI agent #
Ask an LLM
“How do I create an agent isolated to a single project?”
“Is a project-scoped agent limited by the project's plan quota?”
Tell an agent
Create project agent {name} in project {project_id}, org {org_id}, on model {model} with tools {tools}.
Add agent {name} to project {project_id} (org {org_id}) using {model}, skills {tools}, guardrails {guardrails}.
DELETE /v1/ai-agents/organizations/{org_id}/projects/{project_id}/{id} Delete a project AI agent · Delete project AI agent #
Ask an LLM
“How do I permanently delete an agent from a project?”
“Does deleting a project agent also shut down its runner?”
Tell an agent destructive · confirm first
Delete project agent {id} from project {project_id}, org {org_id}.
Permanently remove agent {id} in project {project_id} of organization {org_id}.
GET /v1/ai-agents/organizations/{org_id}/projects/{project_id}/{id} Get a project AI agent's configuration · Get project AI agent #
Ask an LLM
“How is a particular project agent configured?”
“What model and skills does a given project-scoped agent use?”
Tell an agent
Get project agent {id} in project {project_id}, org {org_id}.
Show the full config of agent {id} under project {project_id} in organization {org_id}.
PATCH /v1/ai-agents/organizations/{org_id}/projects/{project_id}/{id} Update a project AI agent · Update project AI agent #
Ask an LLM
“Can I switch the model on an existing project agent?”
“How do I pause a project-scoped agent without deleting it?”
Tell an agent
Change project agent {id} in project {project_id}, org {org_id}, to model {model}.
Set active to {active} on agent {id} in project {project_id} of organization {org_id}.
DELETE /v1/ai-agents/organizations/{org_id}/{id} Delete an organization AI agent · Delete organization AI agent #
Ask an LLM
“How do I delete an agent owned by my organization?”
“Will removing an org agent stop its running runner?”
Tell an agent destructive · confirm first
Delete organization agent {id} from org {org_id}.
Permanently remove org {org_id}'s agent {id}.
GET /v1/ai-agents/organizations/{org_id}/{id} Get an organization AI agent's configuration · Get organization AI agent #
Ask an LLM
“How is an organization-level agent set up?”
“Which triggers and channels does an org agent have?”
Tell an agent
Get organization agent {id} in org {org_id}.
Show org {org_id}'s agent {id} configuration.
PATCH /v1/ai-agents/organizations/{org_id}/{id} Update an organization AI agent · Update organization AI agent #
Ask an LLM
“Can I change the guardrails on an org-wide agent?”
“Which settings can I edit on an existing organization agent?”
Tell an agent
Update organization agent {id} in org {org_id} with guardrails {guardrails}.
Rename org {org_id}'s agent {id} to {name}.
DELETE /v1/ai-agents/{id} Delete an AI agent · Delete AI agent #
Ask an LLM
“How do I delete one of my agents for good?”
“Are pending scheduled runs cancelled when I delete my agent?”
Tell an agent destructive · confirm first
Delete my agent {id}.
Permanently remove personal agent {id} and cancel its scheduled runs.
GET /v1/ai-agents/{id} Get an AI agent's configuration · Get AI agent #
Ask an LLM
“What model, skills and memory does my agent have?”
“Can I check my personal agent's current status?”
Tell an agent
Get my agent {id}.
Show the full configuration and status of personal agent {id}.
PATCH /v1/ai-agents/{id} Update an AI agent · Update AI agent #
Ask an LLM
“Can I add new skills to one of my existing agents?”
“Is there a way to make my personal agent inactive instead of deleting it?”
Tell an agent
Set the tools on my agent {id} to {tools}.
Mark personal agent {id} active {active}.

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-agents-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-agents-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-agents-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 Agents API
  version: 5.35.0
tags:


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