Bugsnag

bugsnag Collaborators API

Manage collaborators within an organization or project. Collaborators are users who have access to view and manage Bugsnag data.

GitHub OpenAPI

Operations 5

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 /organizations/{organization_id}/collaborators List an organization's collaborators · List organization collaborators #
Ask an LLM
“Who has access to my BugSnag organization?”
“Can I see each collaborator's permissions across the organization?”
Tell an agent
List the collaborators in organization {organization_id}.
Show {per_page} collaborators per page for organization {organization_id}.
POST /organizations/{organization_id}/collaborators Invite a collaborator by email · Invite a collaborator to an organization #
Ask an LLM
“How do I invite a teammate to my organization by email?”
“Can I make a new invitee an admin or limit them to certain projects?”
Tell an agent
Invite {email} to organization {organization_id}.
Invite {email} to organization {organization_id} with access only to projects {project_ids}.
GET /organizations/{organization_id}/collaborators/{collaborator_id} Get a collaborator's role and access · Get an organization collaborator #
Ask an LLM
“What role and project access does a specific collaborator have?”
“Is a given teammate an admin in the organization?”
Tell an agent
Show collaborator {collaborator_id} in organization {organization_id}.
Check which projects collaborator {collaborator_id} can reach in organization {organization_id}.
PATCH /organizations/{organization_id}/collaborators/{collaborator_id} Change a collaborator's permissions · Update a collaborator #
Ask an LLM
“Can I promote an existing collaborator to admin?”
“How do I change which projects a current teammate can access?”
Tell an agent
Make collaborator {collaborator_id} an admin of organization {organization_id}: {is_admin}.
Set collaborator {collaborator_id}'s projects in organization {organization_id} to {project_ids}.
DELETE /organizations/{organization_id}/collaborators/{collaborator_id} Remove a collaborator from an organization · Remove a collaborator #
Ask an LLM
“How do I revoke someone's access to every project in my organization?”
“What happens to a collaborator's project access when I remove them?”
Tell an agent destructive · confirm first
Remove collaborator {collaborator_id} from organization {organization_id}.
Offboard {collaborator_id} so they lose access to organization {organization_id}.

Documentation

📖
Documentation
https://developer.smartbear.com/bugsnag/docs/data-access
📖
APIReference
https://developer.smartbear.com/bugsnag

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bugsnag/refs/heads/main/openapi/bugsnag-collaborators-api-openapi.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/bugsnag:bugsnag-collaborators-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

bugsnag-collaborators-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bugsnag Data Access Collaborators API
  description: The Bugsnag Data Access API provides programmatic access to information about your organization, projects, errors, events, and more. It allows developers to build custom integrations and dashboards using their Bugsnag data. The REST API uses JSON and requires authentication via a personal auth token sent in the Authorization header. It supports querying error trends, project configurations, collaborators, and release information.
  version: '2.0'
  contact:
    name: Bugsnag Support
    url: https://docs.bugsnag.com/api/data-access/
  termsOfService: https://smartbear.com/terms-of-use/
servers:
- url: https://api.bugsnag.com
  description: Bugsnag Production API Server
security:
- tokenAuth: []
tags:
- name: Collaborators
  description: Manage collaborators within an organization or project. Collaborators are users who have access to view and manage Bugsnag data.
paths:
  /organizations/{organization_id}/collaborators:
    get:
      operationId: listOrganizationCollaborators
      summary: List organization collaborators
      description: Returns a list of collaborators for the specified organization. Each collaborator includes their user information and permissions.
      tags:
      - Collaborators
      parameters:
      - $ref: '#/components/parameters/OrganizationId'
      - $ref: '#/components/parameters/PerPage'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Collaborator'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Organization not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      operationId: inviteOrganizationCollaborator
      summary: Invite a collaborator to an organization
      description: Invites a new collaborator to the specified organization by email address. The invited user will receive an email with instructions to join.
      tags:
      - Collaborators
      parameters:
      - $ref: '#/components/parameters/OrganizationId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollaboratorInvite'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collaborator'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /organizations/{organization_id}/collaborators/{collaborator_id}:
    get:
      operationId: getOrganizationCollaborator
      summary: Get an organization collaborator
      description: Returns the details of a specific collaborator within an organization, including their role and project access.
      tags:
      - Collaborators
      parameters:
      - $ref: '#/components/parameters/OrganizationId'
      - $ref: '#/components/parameters/CollaboratorId'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collaborator'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Collaborator not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    patch:
      operationId: updateOrganizationCollaborator
      summary: Update a collaborator
      description: Updates the permissions or role of an existing collaborator within an organization.
      tags:
      - Collaborators
      parameters:
      - $ref: '#/components/parameters/OrganizationId'
      - $ref: '#/components/parameters/CollaboratorId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollaboratorUpdate'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collaborator'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Collaborator not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    delete:
      operationId: removeOrganizationCollaborator
      summary: Remove a collaborator
      description: Removes a collaborator from the specified organization. The user will lose access to all projects within the organization.
      tags:
      - Collaborators
      parameters:
      - $ref: '#/components/parameters/OrganizationId'
      - $ref: '#/components/parameters/CollaboratorId'
      responses:
        '204':
          description: Collaborator removed successfully
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Collaborator not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    OrganizationId:
      name: organization_id
      in: path
      required: true
      description: The unique identifier of the organization.
      schema:
        type: string
    PerPage:
      name: per_page
      in: query
      description: The number of results to return per page. Used for pagination.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 30
    CollaboratorId:
      name: collaborator_id
      in: path
      required: true
      description: The unique identifier of the collaborator.
      schema:
        type: string
  schemas:
    Collaborator:
      type: object
      description: Represents a user who has been granted access to an organization or project in Bugsnag.
      properties:
        id:
          type: string
          description: The unique identifier of the collaborator.
        name:
          type: string
          description: The collaborator's name.
        email:
          type: string
          format: email
          description: The collaborator's email address.
        is_admin:
          type: boolean
          description: Whether the collaborator has administrator privileges.
        projects_url:
          type: string
          format: uri
          description: The API URL to list projects accessible to this collaborator.
        created_at:
          type: string
          format: date-time
          description: The date and time the collaborator was added.
        gravatar_url:
          type: string
          format: uri
          description: The Gravatar URL for the collaborator's profile image.
        two_factor_enabled:
          type: boolean
          description: Whether the collaborator has two-factor authentication enabled.
    CollaboratorInvite:
      type: object
      description: Request body for inviting a collaborator to an organization.
      required:
      - email
      properties:
        email:
          type: string
          format: email
          description: The email address of the person to invite.
        is_admin:
          type: boolean
          description: Whether to grant administrator privileges.
        project_ids:
          type: array
          items:
            type: string
          description: List of project IDs the collaborator should have access to.
    CollaboratorUpdate:
      type: object
      description: Request body for updating a collaborator's permissions.
      properties:
        is_admin:
          type: boolean
          description: Whether the collaborator should have administrator privileges.
        project_ids:
          type: array
          items:
            type: string
          description: Updated list of project IDs the collaborator should access.
    Error:
      type: object
      description: An API error response.
      properties:
        errors:
          type: array
          items:
            type: string
          description: List of error messages.
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Personal auth token sent as "token YOUR-AUTH-TOKEN". The token can be found in the Bugsnag account settings under the API section.
externalDocs:
  description: Bugsnag Data Access API Documentation
  url: https://docs.bugsnag.com/api/data-access/