Connections Companies API

The Companies API from Connections — 10 operation(s) for companies.

GitHub OpenAPI

Operations 16

GET /v1/companies List the companies you own - the cross-plane ORG namespace Pay / Analytics /… #
POST /v1/companies Create a company ({name}) - idempotent by name; returns {id, name, slug}. #
GET /v1/companies/{id}/facts Read what the member has told apps about this company… #
POST /v1/companies/{id}/facts Save up to 50 facts about this company ({facts:[{key,value,label?,origin,sourceD… #
DELETE /v1/companies/{id}/facts/{key} Delete one fact about this company: 204, or 404 unknown_fact. #
PATCH /v1/companies/{id} Rename a company you own ({name}). - session, or key with companies:write #
DELETE /v1/companies/{id} Delete a company you own (a Sign-in-with-Connections token is refused: 403… #
GET /v1/companies/{id}/seat-portal Read this company's own ENTERPRISE SEAT PORTAL: whether it's turned on, its… #
POST /v1/companies/{id}/seat-portal Create or update this company's enterprise seat portal - claim its public link… #
GET /v1/companies/{id}/seat-portal/requests List the seat requests people have submitted through this company's public seat… #
POST /v1/companies/{id}/seat-portal/requests/{requestId} Approve or decline ONE pending seat request from this company's public seat… #
GET /v1/companies/{id}/seats List who currently holds a seat in this company: their account sub, a… #
POST /v1/companies/{id}/seats Give someone a seat in this company by email, so they can access it right away… #
DELETE /v1/companies/{id}/seats/{granteeSub} Take away someone's seat in this company immediately - {granteeSub} is the… #
GET /v1/companies/{id}/legal/{kind} Read one of a company's two HOSTED LEGAL DOCUMENTS. #
POST /v1/companies/{id}/legal/{kind} Write (create or replace) one of a company's two HOSTED LEGAL DOCUMENTS and… #

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/connections-icu:connections-icu-companies-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.

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

OpenAPI Specification

connections-icu-companies-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Connections Icu Companies API
  version: 1.0.0
  description: 'Operations tagged Companies across 2 of this provider''s published API definitions: connections-icu-studio-openapi-original.json, connections-icu-studio-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://studio.connectionsapi.com
tags:
- name: Companies
paths:
  /v1/companies:
    get:
      summary: List the companies you own - the cross-plane ORG namespace Pay / Analytics /…
      security:
      - aegisBearer: []
      - apiKey: []
      tags:
      - Companies
      operationId: getV1Companies
      x-operation-id-source: derived
    post:
      summary: Create a company ({name}) - idempotent by name; returns {id, name, slug}.
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: REQUIRED. The display name. Blank is a 400.
      tags:
      - Companies
      operationId: postV1Companies
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/facts:
    get:
      summary: Read what the member has told apps about this company…
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: getV1CompaniesByIdFacts
      x-operation-id-source: derived
    post:
      summary: Save up to 50 facts about this company ({facts:[{key,value,label?,origin,sourceD…
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - facts
              properties:
                facts:
                  type: array
                  maxItems: 50
                  items:
                    type: object
                    required:
                    - key
                    - value
                    - origin
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: postV1CompaniesByIdFacts
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/facts/{key}:
    delete:
      summary: 'Delete one fact about this company: 204, or 404 unknown_fact.'
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: key
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: deleteV1CompaniesByIdFactsByKey
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}:
    patch:
      summary: Rename a company you own ({name}). - session, or key with companies:write
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: REQUIRED. The display name. Blank is a 400.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: patchV1CompaniesById
      x-operation-id-source: derived
    delete:
      summary: 'Delete a company you own (a Sign-in-with-Connections token is refused: 403…'
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: deleteV1CompaniesById
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/seat-portal:
    get:
      summary: 'Read this company''s own ENTERPRISE SEAT PORTAL: whether it''s turned on, its…'
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: getV1CompaniesByIdSeatPortal
      x-operation-id-source: derived
    post:
      summary: Create or update this company's enterprise seat portal - claim its public link…
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                displayName:
                  type: string
                  description: 'Shown on the public page in place of the company''s own name. Alias: display_name.'
                headline:
                  type: string
                  description: A short line under the display name/logo.
                bodyHtml:
                  type: string
                  description: 'The main marketing copy as HTML - headings, paragraphs, lists are kept, scripts stripped. Alias: body_html.'
                contactEmail:
                  type: string
                  description: 'Shown on the page for questions. Alias: contact_email.'
                logoUrl:
                  type: string
                  description: 'Alias: logo_url.'
                  format: uri
                accentColor:
                  type: string
                  description: 'Alias: accent_color.'
                theme:
                  type: string
                  enum:
                  - light
                  - dark
                  description: Appearance of the PUBLIC page.
                publicSlug:
                  type: string
                  description: 'The URL handle (seats.connections.icu/{slug}). Derived from the company name on first save if omitted. Alias: public_slug.'
                requestPolicy:
                  type: string
                  enum:
                  - open
                  - closed
                  description: '''open'' lets a visitor submit a seat request on the public page; ''closed'' hides the request form. Alias: request_policy.'
                enabled:
                  type: boolean
                  description: true PUBLISHES the page at the public link above; false takes it down. See this operation's own warning.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: postV1CompaniesByIdSeatPortal
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/seat-portal/requests:
    get:
      summary: List the seat requests people have submitted through this company's public seat…
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: getV1CompaniesByIdSeatPortalRequests
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/seat-portal/requests/{requestId}:
    post:
      summary: Approve or decline ONE pending seat request from this company's public seat…
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              properties:
                action:
                  type: string
                  enum:
                  - approve
                  - decline
                  description: REQUIRED.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: requestId
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: postV1CompaniesByIdSeatPortalRequestsByRequestId
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/seats:
    get:
      summary: 'List who currently holds a seat in this company: their account sub, a…'
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: getV1CompaniesByIdSeats
      x-operation-id-source: derived
    post:
      summary: Give someone a seat in this company by email, so they can access it right away…
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              properties:
                email:
                  type: string
                  description: REQUIRED. The Connections account's email address to give a seat to.
                scopes:
                  type: array
                  items:
                    type: string
                  description: Optional. Narrows the seat to specific '<plane>:<permission>' strings instead of full access. Omit for full access.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: postV1CompaniesByIdSeats
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/seats/{granteeSub}:
    delete:
      summary: Take away someone's seat in this company immediately - {granteeSub} is the…
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: granteeSub
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: deleteV1CompaniesByIdSeatsByGranteeSub
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
  /v1/companies/{id}/legal/{kind}:
    get:
      summary: Read one of a company's two HOSTED LEGAL DOCUMENTS.
      security:
      - aegisBearer: []
      - apiKey: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: kind
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: getV1CompaniesByIdLegalByKind
      x-operation-id-source: derived
    post:
      summary: Write (create or replace) one of a company's two HOSTED LEGAL DOCUMENTS and…
      security:
      - aegisBearer: []
      - apiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - bodyHtml
              properties:
                bodyHtml:
                  type: string
                  description: 'REQUIRED. The document''s own text as HTML - headings, paragraphs and lists are kept, scripts are stripped server-side. This is the member''s OWN wording: Connections hosts it and never writes, reviews, or endorses it.'
                title:
                  type: string
                  description: Heading shown on the public page. Defaults to 'Privacy Policy' or 'Terms of Service'.
                isPublished:
                  type: boolean
                  description: true publishes it at the public URL; false keeps it a draft and the URL 404s. Save once as a draft to reserve the link.
                publicSlug:
                  type: string
                  description: The URL handle. Derived from the company name on first save; 409 slug_taken if another company already holds it.
                theme:
                  type: string
                  description: Appearance of the PUBLIC page - the publisher's choice, not the visitor's device.
                  enum:
                  - light
                  - dark
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: kind
        in: path
        required: true
        schema:
          type: string
      tags:
      - Companies
      operationId: postV1CompaniesByIdLegalByKind
      x-operation-id-source: derived
    servers:
    - url: https://studio.connectionsapi.com
components:
  securitySchemes:
    aegisBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: The AEGIS SSO access token (Cognito JWT from the shared sign-in) presented as a Bearer on every /v1 call.
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: cnx_live_* | cnx_pub_*
      description: 'A key minted in the console, sent as a bearer token. `cnx_live_` carries cross-plane data scopes AND (when granted) Studio management scopes (apps:*, keys:*, projects:*, webhooks:*) that authorize the console-management operations below. `cnx_pub_` is the publishable, browser-safe tier (Stripe''s pk_ model): mint-time capped to :read scopes, requires a non-empty allowed-origins allowlist, refused on any non-GET/HEAD route, and rate-limited - safe to embed in client-side code.'
    oauthUserToken:
      type: http
      scheme: bearer
      description: EITHER (a) a Sign-in-with-Connections USER access token issued by accounts.connectionsapi.com to a registered OAuth app - the app acts on behalf of its signed-in user, rows are keyed by the token's own sub + client_id; OR (b) an app-bound publishable key (cnx_pub_, minted with an appId) presented on X-Connections-Api-Key ALONGSIDE the signed-in user's own plain AEGIS bearer on Authorization - the server derives (app_id, sub) from the two verified credentials. The publishable key alone authorizes nothing; both credentials are required. This second form is for a developer who wants the locker without standing up a full OAuth client - mint one publishable key bound to a registered app instead.
x-refined-from:
- connections-icu-studio-openapi-original.json
- connections-icu-studio-openapi.yml