Stainless API

Stainless API as documented publicly: 24 operations. Contract generated from the documentation by API Evangelist (2026-10-24); not the provider's own document.

Operations 24

GET /accounts/{accountId}/friends Get friends for this an account #
GET /status API status check #
GET /v0/build_target_outputs Download build target output #
GET /v0/builds List project builds #
POST /v0/builds Create build #
POST /v0/builds/compare Creates two comparable builds #
GET /v0/builds/{buildid} Retrieve build #
GET /v0/builds/{buildid}/diagnostics Get diagnostics for a build #
GET /v0/orgs List organizations #
GET /v0/orgs/{org} Retrieve an organization #
GET /v0/projects List projects #
POST /v0/projects Create project #
GET /v0/projects/{project} Retrieve project #
PATCH /v0/projects/{project} Update project #
GET /v0/projects/{project}/branches List project branches #
POST /v0/projects/{project}/branches Create a new project branch #
DELETE /v0/projects/{project}/branches/{branch} Delete a project branch #
GET /v0/projects/{project}/branches/{branch} Retrieve a project branch #
PUT /v0/projects/{project}/branches/{branch}/rebase Rebase a project branch #
PUT /v0/projects/{project}/branches/{branch}/reset Reset #
GET /v0/projects/{project}/configs Retrieve configuration files #
POST /v0/projects/{project}/configs/guess Generate config suggestions #
POST /v0/projects/{project}/generate_commit_message POST /v0/projects/{project}/generate_commit_message #
GET /v0/user Retrieve the current user #

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/stainlessapi-com:stainlessapi-com-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.

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

OpenAPI Specification

stainlessapi-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Stainless API
  version: '2026-10-24'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-24: 24 operation(s) read from 14 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Stainless has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 23
    pages-with-code: 6
    pages-read: 14
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-24'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.stainless.com/docs/api
  - https://www.stainless.com/docs/reference/config
  - https://www.stainless.com/docs/api/resources/orgs
  - https://www.stainless.com/docs/api/resources/user
  - https://www.stainless.com/docs/api/resources/builds
  - https://www.stainless.com/docs/api/resources/projects
  - https://www.stainless.com/docs/api/resources/orgs/methods/list
  - https://www.stainless.com/docs/api/resources/builds/methods/list
  - https://www.stainless.com/docs/api/resources/builds/methods/create
  - https://www.stainless.com/docs/api/resources/orgs/methods/retrieve
  - https://www.stainless.com/docs/api/resources/projects/methods/list
  - https://www.stainless.com/docs/api/resources/user/methods/retrieve
  - https://www.stainless.com/docs/api/resources/builds/methods/compare
  - https://www.stainless.com/docs/api/resources/builds/methods/retrieve
paths:
  /accounts/{accountId}/friends:
    get:
      operationId: get_accounts_accountId_friends
      tags:
      - Accounts
      summary: Get friends for this an account
      description: Get friends for this an account
      x-source: https://www.stainless.com/docs/reference/config
      parameters:
      - name: accountId
        in: path
        required: true
        schema:
          type: string
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: The cursor for pagination, which can be populated by the `next_cursor` value of the initial request.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: The number of elements to fetch in the page. Defaults to 20 if not provided.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAccountsAccountidFriendsResponse'
      x-evidence:
        kind: documentation
  /status:
    get:
      operationId: get_status
      tags:
      - Status
      summary: API status check
      description: Endpoint for users to check whether they can reach the api.
      x-source: https://www.stainless.com/docs/reference/config
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStatusResponse'
      x-evidence:
        kind: documentation
  /v0/build_target_outputs:
    get:
      operationId: get_v0_build_target_outputs
      tags:
      - Build Target Outputs
      summary: Download build target output
      x-source: https://www.stainless.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/builds:
    get:
      operationId: get_v0_builds
      tags:
      - Builds
      summary: List project builds
      x-source: https://www.stainless.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v0_builds
      tags:
      - Builds
      summary: Create build
      x-source: https://www.stainless.com/docs/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/builds/compare:
    post:
      operationId: post_v0_builds_compare
      tags:
      - Builds
      summary: Creates two comparable builds
      x-source: https://www.stainless.com/docs/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/builds/{buildid}:
    get:
      operationId: get_v0_builds_buildid
      tags:
      - Builds
      summary: Retrieve build
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: buildid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/builds/{buildid}/diagnostics:
    get:
      operationId: get_v0_builds_buildid_diagnostics
      tags:
      - Builds
      summary: Get diagnostics for a build
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: buildid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/orgs:
    get:
      operationId: get_v0_orgs
      tags:
      - Orgs
      summary: List organizations
      x-source: https://www.stainless.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/orgs/{org}:
    get:
      operationId: get_v0_orgs_org
      tags:
      - Orgs
      summary: Retrieve an organization
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects:
    get:
      operationId: get_v0_projects
      tags:
      - Projects
      summary: List projects
      x-source: https://www.stainless.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v0_projects
      tags:
      - Projects
      summary: Create project
      x-source: https://www.stainless.com/docs/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}:
    get:
      operationId: get_v0_projects_project
      tags:
      - Projects
      summary: Retrieve project
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_v0_projects_project
      tags:
      - Projects
      summary: Update project
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/branches:
    get:
      operationId: get_v0_projects_project_branches
      tags:
      - Projects
      summary: List project branches
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_v0_projects_project_branches
      tags:
      - Projects
      summary: Create a new project branch
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/branches/{branch}:
    delete:
      operationId: delete_v0_projects_project_branches_branch
      tags:
      - Projects
      summary: Delete a project branch
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      - name: branch
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_v0_projects_project_branches_branch
      tags:
      - Projects
      summary: Retrieve a project branch
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      - name: branch
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/branches/{branch}/rebase:
    put:
      operationId: put_v0_projects_project_branches_branch_rebase
      tags:
      - Projects
      summary: Rebase a project branch
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      - name: branch
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/branches/{branch}/reset:
    put:
      operationId: put_v0_projects_project_branches_branch_reset
      tags:
      - Projects
      summary: Reset
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      - name: branch
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/configs:
    get:
      operationId: get_v0_projects_project_configs
      tags:
      - Projects
      summary: Retrieve configuration files
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/configs/guess:
    post:
      operationId: post_v0_projects_project_configs_guess
      tags:
      - Projects
      summary: Generate config suggestions
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/projects/{project}/generate_commit_message:
    post:
      operationId: post_v0_projects_project_generate_commit_message
      tags:
      - Projects
      summary: POST /v0/projects/{project}/generate_commit_message
      x-source: https://www.stainless.com/docs/api
      parameters:
      - name: project
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v0/user:
    get:
      operationId: get_v0_user
      tags:
      - User
      summary: Retrieve the current user
      x-source: https://www.stainless.com/docs/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAccountsAccountidFriendsResponse:
      type: object
      properties:
        has_more:
          type: boolean
        next_cursor:
          type: string
          description: nullable
        data:
          type: array
          description: Array of FriendResponse objects
    GetStatusResponse:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Accounts
- name: Build Target Outputs
- name: Builds
- name: Orgs
- name: Projects
- name: Status
- name: User