BugBug

BugBug Suites API

Retrieving suites

GitHub OpenAPI

Operations 7

GET /v2/suites/ Retrieving suites list #
POST /v2/suites/ Create new suite #
GET /v2/suites/{id}/ Retrieving suite by ID #
PUT /v2/suites/{id}/ Update suite by ID #
PATCH /v2/suites/{id}/ Partially update suite by ID #
DELETE /v2/suites/{id}/ Removing a suite #
PUT /v2/suites/{id}/tags/ Replace suite tags #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/bugbug-io/openapi/bugbug-io-suites-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-v2-project-settings-schema.json
📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-v2-test-run-schema.json
📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-v2-step-run-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-patched-step-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-step-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bugbug-io/json-schema/bugbug-io-v2-suite-run-schema.json

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/bugbug-io:bugbug-io-suites-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

bugbug-io-suites-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BugBug.io Public Suites API
  version: v2
  x-logo:
    url: /static/images/logo.svg
    altText: BugBug.io
  description: 'BugBug.io is a modern browser-based app for software testers, developers, or product managers in need of quick & reliable test automation. You can run tests from your CI/CD pipeline or build system. You can run tests and suites in the cloud via BugBug Command Line Interface.


    Please use Authorize button to Try it out.'
  contact:
    email: support@bugbug.io
tags:
- name: Suites
  description: Retrieving suites
paths:
  /v2/suites/:
    get:
      operationId: v2_suites_list
      description: Returns many suites.
      summary: Retrieving suites list
      parameters:
      - in: query
        name: latestRun
        schema:
          type: boolean
        description: Include the latest run summary for each suite.
      - in: query
        name: ordering
        schema:
          type: string
          enum:
          - -created
          - -name
          - created
          - name
      - name: page
        required: false
        in: query
        description: A page number within the paginated result set.
        schema:
          type: integer
      - name: page_size
        required: false
        in: query
        description: Number of results to return per page.
        schema:
          type: integer
      - in: query
        name: query
        schema:
          type: string
        description: Search in names with the following query
      - in: query
        name: tags
        schema:
          type: string
        description: Comma-separated tag names. Names cannot contain commas. Matching is case-insensitive and uses AND semantics.
      tags:
      - Suites
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedV2SuiteList'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
    post:
      operationId: v2_suites_create
      description: Creates a suite.
      summary: Create new suite
      parameters: []
      tags:
      - Suites
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2SuiteCreate'
        required: true
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2SuiteDetails'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
        '400':
          description: Request body failed validation.
  /v2/suites/{id}/:
    get:
      operationId: v2_suites_retrieve
      description: Returns a single suite.
      summary: Retrieving suite by ID
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this suite.
        required: true
      tags:
      - Suites
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2SuiteDetails'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
        '404':
          description: Resource not found.
    put:
      operationId: v2_suites_update
      description: Updates a suite.
      summary: Update suite by ID
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this suite.
        required: true
      tags:
      - Suites
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2SuiteCreate'
        required: true
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2SuiteDetails'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
        '400':
          description: Request body failed validation.
        '404':
          description: Resource not found.
    patch:
      operationId: v2_suites_partial_update
      description: Partially updates a suite.
      summary: Partially update suite by ID
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this suite.
        required: true
      tags:
      - Suites
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedV2SuiteCreate'
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2SuiteDetails'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
        '400':
          description: Request body failed validation.
        '404':
          description: Resource not found.
    delete:
      operationId: v2_suites_destroy
      description: Remove a suite.
      summary: Removing a suite
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this suite.
        required: true
      tags:
      - Suites
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '204':
          description: No response body
        '401':
          description: Authentication credentials were missing or invalid.
        '404':
          description: Resource not found.
  /v2/suites/{id}/tags/:
    put:
      operationId: v2_suites_tags_update
      description: Replaces tags assigned to the suite. Tag names that do not exist yet are created in the project with a default color.
      summary: Replace suite tags
      parameters:
      - in: path
        name: id
        schema:
          type: string
          format: uuid
        description: A UUID string identifying this suite.
        required: true
      tags:
      - Suites
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2TagAssignmentsUpdate'
      security:
      - tokenAuth: []
      - Bearer: []
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/V2Tag'
          description: ''
        '401':
          description: Authentication credentials were missing or invalid.
        '400':
          description: Request body failed validation.
        '404':
          description: Resource not found.
components:
  schemas:
    V2SuiteDetails:
      type: object
      properties:
        afterAll:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        autoAddNewTests:
          type: boolean
          readOnly: true
        autoRetry:
          type: integer
          readOnly: true
        beforeAfterAllEnabled:
          type: boolean
          readOnly: true
        beforeAll:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type:
          - string
          - 'null'
          readOnly: true
        notes:
          type:
          - string
          - 'null'
          readOnly: true
          title: Suite notes
        runInParallel:
          type: boolean
          readOnly: true
        runProfileId:
          type:
          - string
          - 'null'
          format: uuid
          readOnly: true
        tags:
          type: array
          items:
            $ref: '#/components/schemas/V2Tag'
          readOnly: true
        tests:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        testsCount:
          type: integer
          readOnly: true
        webappUrl:
          type: string
          readOnly: true
      required:
      - afterAll
      - autoAddNewTests
      - autoRetry
      - beforeAfterAllEnabled
      - beforeAll
      - id
      - name
      - notes
      - runInParallel
      - runProfileId
      - tags
      - tests
      - testsCount
      - webappUrl
    PatchedV2SuiteCreate:
      type: object
      properties:
        autoAddNewTests:
          type: boolean
        autoRetry:
          type: integer
          maximum: 5
          minimum: 0
        beforeAfterAllEnabled:
          type: boolean
        notes:
          type:
          - string
          - 'null'
          title: Suite notes
        name:
          type:
          - string
          - 'null'
          maxLength: 100
        runInParallel:
          type: boolean
        runProfileId:
          type: string
          format: uuid
        tests:
          type: array
          items:
            type: string
            format: uuid
        beforeAll:
          type: array
          items:
            type: string
            format: uuid
        afterAll:
          type: array
          items:
            type: string
            format: uuid
        tags:
          type: array
          items:
            type: string
            maxLength: 64
          writeOnly: true
          maxItems: 64
        tagIds:
          type: array
          items:
            type: string
            format: uuid
          writeOnly: true
          maxItems: 64
    PaginatedV2SuiteList:
      type: object
      required:
      - count
      - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/V2Suite'
    V2Suite:
      type: object
      properties:
        afterAll:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        autoAddNewTests:
          type: boolean
          readOnly: true
        autoRetry:
          type: integer
          readOnly: true
        beforeAfterAllEnabled:
          type: boolean
          readOnly: true
        beforeAll:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type:
          - string
          - 'null'
          readOnly: true
        notes:
          type:
          - string
          - 'null'
          readOnly: true
          title: Suite notes
        runInParallel:
          type: boolean
          readOnly: true
        runProfileId:
          type:
          - string
          - 'null'
          format: uuid
          readOnly: true
        tags:
          type: array
          items:
            $ref: '#/components/schemas/V2Tag'
          readOnly: true
        tests:
          type: array
          items:
            type: object
            additionalProperties: {}
          readOnly: true
        testsCount:
          type: integer
          readOnly: true
      required:
      - afterAll
      - autoAddNewTests
      - autoRetry
      - beforeAfterAllEnabled
      - beforeAll
      - id
      - name
      - notes
      - runInParallel
      - runProfileId
      - tags
      - tests
      - testsCount
    V2Tag:
      type: object
      properties:
        color:
          type: string
          readOnly: true
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type: string
          readOnly: true
      required:
      - color
      - id
      - name
    V2TagAssignmentsUpdate:
      type: object
      properties:
        tags:
          type: array
          items:
            type: string
            maxLength: 64
          maxItems: 64
        tagIds:
          type: array
          items:
            type: string
            format: uuid
          maxItems: 64
    V2SuiteCreate:
      type: object
      properties:
        autoAddNewTests:
          type: boolean
        autoRetry:
          type: integer
          maximum: 5
          minimum: 0
        beforeAfterAllEnabled:
          type: boolean
        notes:
          type:
          - string
          - 'null'
          title: Suite notes
        name:
          type:
          - string
          - 'null'
          maxLength: 100
        runInParallel:
          type: boolean
        runProfileId:
          type: string
          format: uuid
        tests:
          type: array
          items:
            type: string
            format: uuid
        beforeAll:
          type: array
          items:
            type: string
            format: uuid
        afterAll:
          type: array
          items:
            type: string
            format: uuid
        tags:
          type: array
          items:
            type: string
            maxLength: 64
          writeOnly: true
          maxItems: 64
        tagIds:
          type: array
          items:
            type: string
            format: uuid
          writeOnly: true
          maxItems: 64
      required:
      - runProfileId
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"