IntegrationOS

IntegrationOS AI Skills API

Manage AI skills with session or secret key authentication

GitHub OpenAPI

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://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/openapi/integration-os-ai-skills-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-skills-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-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://raw.githubusercontent.com/api-evangelist/integration-os/refs/heads/main/openapi/integration-os-ai-skills-api-openapi.yml