IntegrationOS

IntegrationOS AI Skills API

Manage AI skills with session or secret key authentication

GitHub OpenAPI
Business capability
Agent Tool Exposure AE-100.10

Operations 27

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-skills List the AI skills in my account · List AI skills #
Ask an LLM
“Which AI skills are available in my personal account?”
“Can I page through my own AI skills a few at a time?”
Tell an agent
List the AI skills in my account.
Show page {page} of my personal AI skills, {limit} per page.
POST /v1/ai-skills Create a personal AI skill · Create personal AI skill #
Ask an LLM
“How do I write a new AI skill for myself with its own prompt and allowed tools?”
“Can I pick the model a personal skill runs on when I create it?”
Tell an agent
Create a personal skill {name} described as {description} with prompt {content}.
Make me a skill named {name} ({description}) using model {model} and tools {allowedTools}, prompt: {content}.
GET /v1/ai-skills/organizations/{org_id} List an organization's AI skills · List organization AI skills #
Ask an LLM
“Which AI skills are shared across every project in my organization?”
“Can I page through an organization's skill catalogue?”
Tell an agent
List the AI skills owned by organization {org_id}.
Show page {page} of org {org_id}'s skills.
POST /v1/ai-skills/organizations/{org_id} Create an organization-wide AI skill · Create organization AI skill #
Ask an LLM
“How do I add an AI skill that every project in my organization can use?”
“Can an organization skill be restricted to certain tools when it's created?”
Tell an agent
Create organization {org_id} skill {name} described as {description} with prompt {content}.
Add org-wide skill {name} to {org_id} ({description}), allowing tools {allowedTools}, prompt {content}.
GET /v1/ai-skills/organizations/{org_id}/projects/{project_id} List a project's AI skills · List project AI skills #
Ask an LLM
“What AI skills are isolated to one particular project?”
“Can I list only the skills scoped to a single project rather than the whole org?”
Tell an agent
List the AI skills in project {project_id} of org {org_id}.
Show page {page} of project {project_id} skills in organization {org_id}.
POST /v1/ai-skills/organizations/{org_id}/projects/{project_id} Create an AI skill scoped to one project · Create project AI skill #
Ask an LLM
“How do I create an AI skill that only one project can see?”
“Can I tag a project skill when I create it?”
Tell an agent
Create skill {name} in project {project_id}, org {org_id}, described as {description} with prompt {content}.
Add project-only skill {name} to project {project_id} (org {org_id}) tagged {tags}: {description}, prompt {content}.
DELETE /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id} Delete a project AI skill and all versions · Delete project AI skill #
Ask an LLM
“How do I permanently delete a project skill along with every version?”
“What happens to agents in the project that still call a deleted skill?”
Tell an agent destructive · confirm first
Delete skill {id} from project {project_id} in org {org_id}.
Permanently remove project {project_id} skill {id} and its versions, organization {org_id}.
GET /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id} Get a project AI skill's details · Get project AI skill #
Ask an LLM
“What prompt, tools and live version does a project skill currently have?”
“Can I view one project-scoped skill's full definition?”
Tell an agent
Get skill {id} in project {project_id}, org {org_id}.
Show the prompt and tools of project {project_id} skill {id} under organization {org_id}.
PUT /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id} Edit a project AI skill's draft · Update project AI skill #
Ask an LLM
“How do I edit the draft of a skill that belongs to a project?”
“Do edits to a project skill go live immediately, or only after publishing?”
Tell an agent
Update the draft prompt of skill {id} in project {project_id}, org {org_id}, to {content}.
Switch project {project_id} skill {id} draft to model {model} in organization {org_id}.
GET /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id}/export Export a project skill as SKILL.md · Export project AI skill #
Ask an LLM
“Can I download a project skill's live version as a SKILL.md file?”
“How do I get a project-scoped skill into markdown for version control?”
Tell an agent
Export project {project_id} skill {id} in org {org_id} as SKILL.md.
Download the live markdown of skill {id} from project {project_id}, organization {org_id}.
POST /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id}/publish Publish a project skill's draft as live · Publish project AI skill #
Ask an LLM
“How do I release the draft of a project skill as a new live version?”
“Are published versions of a project skill immutable?”
Tell an agent
Publish the draft of skill {id} in project {project_id}, org {org_id}.
Release project {project_id} skill {id} as a new live version in organization {org_id}.
GET /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id}/versions List a project skill's version history · List project AI skill versions #
Ask an LLM
“What versions has a project skill gone through?”
“Can I filter a project skill's versions by verification status?”
Tell an agent
List page {page} of versions for skill {id} in project {project_id}, org {org_id}.
Show project {project_id} skill {id} versions with status {verificationStatus}, page {page}, org {org_id}.
POST /v1/ai-skills/organizations/{org_id}/projects/{project_id}/{id}/versions/{version}/yank Yank a bad version of a project skill · Yank project AI skill version #
Ask an LLM
“How do I roll back a bad release of a project skill in an emergency?”
“Do I have to give a reason when yanking a project skill version?”
Tell an agent destructive · confirm first
Yank version {version} of skill {id} in project {project_id}, org {org_id}, because {reason}.
Pull project {project_id} skill {id} release {version} in organization {org_id}; reason: {reason}.
DELETE /v1/ai-skills/organizations/{org_id}/{id} Delete an organization AI skill · Delete organization AI skill #
Ask an LLM
“How do I permanently remove an org-wide skill and every version of it?”
“Will agents across the organization break if I delete a shared skill?”
Tell an agent destructive · confirm first
Delete organization {org_id} skill {id}.
Permanently remove org-wide skill {id} and its versions from {org_id}.
GET /v1/ai-skills/organizations/{org_id}/{id} Get an organization AI skill's details · Get organization AI skill #
Ask an LLM
“What does an organization-wide skill's prompt and tool list look like?”
“Which version of an org skill is currently live?”
Tell an agent
Get organization {org_id} skill {id}.
Show the full definition of org-wide skill {id} in {org_id}.
PUT /v1/ai-skills/organizations/{org_id}/{id} Edit an organization AI skill's draft · Update organization AI skill #
Ask an LLM
“How do I change the draft of a skill shared across my organization?”
“Can I make an organization skill public by editing it?”
Tell an agent
Update the draft prompt of organization {org_id} skill {id} to {content}.
Set org-wide skill {id} in {org_id} public = {public}.
GET /v1/ai-skills/organizations/{org_id}/{id}/export Export an organization skill as SKILL.md · Export organization AI skill #
Ask an LLM
“Can I download an organization skill's live version as markdown?”
“How do I back up a shared org skill as a SKILL.md document?”
Tell an agent
Export organization {org_id} skill {id} as SKILL.md.
Download the live markdown of org-wide skill {id} in {org_id}.
POST /v1/ai-skills/organizations/{org_id}/{id}/publish Publish an organization skill's draft · Publish organization AI skill #
Ask an LLM
“How do I make my edits to an organization skill go live?”
“Does publishing an org skill create a new immutable version?”
Tell an agent
Publish the draft of organization {org_id} skill {id}.
Release org-wide skill {id} in {org_id} as a new live version.
GET /v1/ai-skills/organizations/{org_id}/{id}/versions List an organization skill's versions · List organization AI skill versions #
Ask an LLM
“What is the release history of a skill shared across my organization?”
“Can I list only the verified versions of an org skill?”
Tell an agent
List page {page} of versions for organization {org_id} skill {id}.
Show org-wide skill {id} versions in {org_id} with status {verificationStatus}, page {page}.
POST /v1/ai-skills/organizations/{org_id}/{id}/versions/{version}/yank Yank a bad version of an organization skill · Yank organization AI skill version #
Ask an LLM
“How do I pull a broken release of an organization-wide skill?”
“Is the reason for yanking an org skill version kept for audit?”
Tell an agent destructive · confirm first
Yank version {version} of organization {org_id} skill {id} because {reason}.
Pull org-wide skill {id} release {version} in {org_id}; reason: {reason}.
DELETE /v1/ai-skills/{id} Delete one of my AI skills · Delete AI skill #
Ask an LLM
“How do I permanently delete a personal skill and all its versions?”
“Do agents calling my skill fail right away once it's deleted?”
Tell an agent destructive · confirm first
Delete AI skill {id}.
Permanently remove my skill {id} with every version.
GET /v1/ai-skills/{id} Get one of my AI skills · Get AI skill #
Ask an LLM
“What prompt, tools and published version does one of my skills have?”
“Can I look up any AI skill I own by ID alone?”
Tell an agent
Get AI skill {id}.
Show the metadata and current live version of my skill {id}.
PUT /v1/ai-skills/{id} Edit the draft of one of my AI skills · Update AI skill #
Ask an LLM
“Will editing my skill affect agents currently running its live version?”
“How do I change the allowed tools on a personal skill's draft?”
Tell an agent
Update the draft prompt of my skill {id} to {content}.
Change personal skill {id}'s draft allowed tools to {allowedTools}.
GET /v1/ai-skills/{id}/export Export my AI skill as SKILL.md · Export AI skill #
Ask an LLM
“Can I download one of my skills as a SKILL.md file to keep in source control?”
“How do I share a personal skill outside the platform?”
Tell an agent
Export my skill {id} as SKILL.md.
Download the live markdown of personal skill {id}.
POST /v1/ai-skills/{id}/publish Publish my AI skill's draft as live · Publish AI skill #
Ask an LLM
“How do I release my skill's draft so agents tracking latest pick it up?”
“Are agents pinned to an older version affected when I publish my skill?”
Tell an agent
Publish the draft of my skill {id}.
Release personal skill {id} as a new live version.
GET /v1/ai-skills/{id}/versions List the versions of my AI skill · List AI skill versions #
Ask an LLM
“What changed across the releases of one of my skills?”
“Which version of my skill should I pin an agent to?”
Tell an agent
List page {page} of versions for my skill {id}.
Show personal skill {id} versions with status {verificationStatus}, page {page}.
POST /v1/ai-skills/{id}/versions/{version}/yank Yank a bad version of my AI skill · Yank AI skill version #
Ask an LLM
“How do I stop a broken release of my skill from being selected as live?”
“Can I roll back my skill quickly after a bad publish?”
Tell an agent destructive · confirm first
Yank version {version} of my skill {id} because {reason}.
Pull personal skill {id} release {version}; reason: {reason}.

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://artifacts.apis.io/integration-os/openapi/integration-os-ai-skills-api-openapi.yml

Other Resources

🔗
ToolCrosswalk
https://artifacts.apis.io/integration-os/mcp/integration-os-tool-crosswalk.yml
🔗
Webhooks
https://artifacts.apis.io/integration-os/asyncapi/integration-os-webhooks.yml
🔗
ErrorCatalog
https://artifacts.apis.io/integration-os/errors/integration-os-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/integration-os/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://artifacts.apis.io/integration-os/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-skills-api"
All apis 
curl "https://apis.io/api/v1/apis?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. 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-skills-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 Skills API
  version: 5.35.0
tags:


# --- truncated at 32 KB (80 KB total) ---
# Full source: https://artifacts.apis.io/integration-os/openapi/integration-os-ai-skills-api-openapi.yml