IntegrationOS

IntegrationOS Organizations API

Programmatically manage organizations, their members, invitations, AuthKit configuration, and API keys with a service-account API key

GitHub OpenAPI

Operations 16

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

POST /v1/management/organizations/setup Create an organization with a service key · Setup Organization #
Ask an LLM
“How do I set up a new organization and get its service-account key in one step?”
“Can I name the API key that gets minted when I create an organization?”
Tell an agent
Set up a new organization called {name}.
Create organization {name} and mint its service-account key named {key_name}.
DELETE /v1/management/organizations/{org_id} Delete an organization · Delete Organization #
Ask an LLM
“How do I delete an organization I no longer need?”
“Why does deleting my organization fail when it still has projects?”
Tell an agent destructive · confirm first
Delete organization {org_id}.
Soft-delete org {org_id} now that its projects are gone.
GET /v1/management/organizations/{org_id} Get an organization's settings · Get Organization #
Ask an LLM
“What members and projects does my organization have?”
“Where can I see an organization's current name and description?”
Tell an agent
Show the settings for organization {org_id}.
Fetch org {org_id} with its members and projects.
PUT /v1/management/organizations/{org_id} Rename or redescribe an organization · Update Organization Settings #
Ask an LLM
“How do I rename my organization?”
“Can I change an organization's description after setup?”
Tell an agent
Rename organization {org_id} to {name}.
Set org {org_id}'s description to {description}.
PUT /v1/management/organizations/{org_id}/authkit Configure organization-level embeddable auth · Configure Organization Embeddable Auth #
Ask an LLM
“How do I set up embeddable OAuth for a connector across my whole organization?”
“Can my organization use the default OAuth credentials instead of its own client?”
Tell an agent
Turn on embeddable auth for connector definition {connection_definition_id} in org {org_id}, {environment} environment, active {active}.
Set org {org_id}'s embeddable auth OAuth client id to {client_id} with scopes {scopes}.
GET /v1/management/organizations/{org_id}/invitations List pending organization invitations · List Organization Invitations #
Ask an LLM
“Who has been invited to my organization but not joined yet?”
“Can I see all outstanding org invites?”
Tell an agent
List pending invitations for organization {org_id}.
Show who is still invited to org {org_id}.
POST /v1/management/organizations/{org_id}/invitations Invite someone to an organization · Create Organization Invitation #
Ask an LLM
“How do I invite a teammate to my organization by email?”
“Can I set a role and expiry on an organization invite?”
Tell an agent
Invite {email} to organization {org_id}.
Invite {email} to org {org_id} with role {role_key}, expiring {expires_at}.
DELETE /v1/management/organizations/{org_id}/invitations/{invitation_id} Revoke an organization invitation · Revoke Organization Invitation #
Ask an LLM
“How do I cancel an invitation to my organization before it is accepted?”
“Can I withdraw a project invite from the organization level?”
Tell an agent destructive · confirm first
Revoke invitation {invitation_id} in organization {org_id}.
Cancel pending invite {invitation_id} under org {org_id}.
POST /v1/management/organizations/{org_id}/invitations/{invitation_id}/resend Resend an organization invitation · Resend Organization Invitation #
Ask an LLM
“Can I resend an organization invite email that someone missed?”
“Does resending an invite issue a new token?”
Tell an agent
Resend invitation {invitation_id} for organization {org_id}.
Rotate the token on org {org_id}'s invite {invitation_id} and email it again.
GET /v1/management/organizations/{org_id}/keys List an organization's API keys · List Organization Keys #
Ask an LLM
“Which API keys are scoped to my organization?”
“Does the organization key list include the service-account key?”
Tell an agent
List API keys for organization {org_id}.
Show every org-scoped key in org {org_id} for this environment.
POST /v1/management/organizations/{org_id}/keys Create an organization API key · Create Organization Key #
Ask an LLM
“How do I mint an extra API key for my organization?”
“Can I give a new org-scoped key a name?”
Tell an agent
Create a new API key for organization {org_id}.
Mint an org-scoped key named {name} in org {org_id}.
DELETE /v1/management/organizations/{org_id}/keys/{key_id} Revoke an organization API key · Delete Organization Key #
Ask an LLM
“How do I revoke an organization API key I created?”
“Can I delete the organization's service-account key this way?”
Tell an agent destructive · confirm first
Delete API key {key_id} from organization {org_id}.
Revoke org {org_id}'s key {key_id}.
PUT /v1/management/organizations/{org_id}/keys/{key_id}/configure Set passthrough rules on an org key · Configure Organization Key Access #
Ask an LLM
“Can I restrict which passthrough methods an organization key may call?”
“How do I replace the access rules on an org-scoped API key?”
Tell an agent
Limit organization key {key_id} in org {org_id} to methods {methods}.
Replace the passthrough rules on org {org_id}'s key {key_id} with {rules}.
GET /v1/management/organizations/{org_id}/members List organization members · List Organization Members #
Ask an LLM
“Who belongs to my organization?”
“Can I page through every user in an org?”
Tell an agent
List members of organization {org_id}.
Show all users in org {org_id}.
PUT /v1/management/organizations/{org_id}/members Change a member's organization role · Update Organization Member Role #
Ask an LLM
“How do I promote a user to a different role in my organization?”
“Can I change someone's org-level role without removing them?”
Tell an agent
Give user {user_id} the role {role_key} in organization {org_id}.
Change {user_id}'s org {org_id} role to {role_key}.
DELETE /v1/management/organizations/{org_id}/members/{user_id} Remove a member from an organization · Remove Organization Member #
Ask an LLM
“How do I remove someone from my organization?”
“Does removing an org member delete their user account?”
Tell an agent destructive · confirm first
Remove user {user_id} from organization {org_id}.
Take {user_id} out of org {org_id} but keep their account.

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-organizations-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-organizations-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-organizations-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 Organizations API
  version: 5.35.0
tags:


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