Overops Labels API

Fetch and manipulate events labels

Operations 7

POST /services/{env_id}/events/{event_id}/inbox Move to Inbox
POST /services/{env_id}/events/{event_id}/delete Move to Trash
POST /services/{env_id}/events/{event_id}/resolve Mark as resolved
GET /services/{env_id}/labels List labels
POST /services/{env_id}/labels Create new label
POST /services/{env_id}/events/labels Batch Add/Remove labels
POST /services/{env_id}/events/{event_id}/labels Add/Remove labels

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/overops-labels-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

overops-labels-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: v1
  title: Services Alerts Labels API
  contact:
    email: hello@overops.com
  description: "Main OverOps API.\nThe REST API layer enables OverOps admins and users to perform and automate all actions\nprovided by the OverOps UI available at https://app.overops.com (or On-premises equivalent URL) via a platform independent programmatic interface.\nA wrapper Java client API library that leverages these APIs for convenience by\nJava and Scala developers is available at https://github.com/takipi/api-client and on Maven Central.\n\nAll calls must be authenticated using one of the following methods:\n  1. Using `x-api-key` header (To generate the token, go to `Settings` --> `Account Settings` in the OverOps App). This is the recommended method.\n  2. Using Basic auth with `username:password` combo.\n"
servers:
- url: https://api.overops.com/api/v1
security:
- basicAuth: []
- ApiKeyAuth: []
tags:
- name: Labels
  description: Fetch and manipulate events labels
paths:
  /services/{env_id}/events/{event_id}/inbox:
    post:
      tags:
      - Labels
      summary: Move to Inbox
      description: Move the specified event into Inbox
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      - in: path
        name: event_id
        description: Event to use
        required: true
        schema:
          type: string
      - in: query
        name: force
        description: Force adding labels, even if it exists
        schema:
          type: boolean
          default: false
      - in: query
        name: handle_similar_events
        description: Change the labels on all similar events
        schema:
          type: boolean
          default: true
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /services/{env_id}/events/{event_id}/delete:
    post:
      tags:
      - Labels
      summary: Move to Trash
      description: Move the specified event into Trash
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      - in: path
        name: event_id
        description: Event to use
        required: true
        schema:
          type: string
      - in: query
        name: force
        description: Force adding labels, even if it exists
        schema:
          type: boolean
          default: false
      - in: query
        name: handle_similar_events
        description: Change the labels on all similar events
        schema:
          type: boolean
          default: true
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /services/{env_id}/events/{event_id}/resolve:
    post:
      tags:
      - Labels
      summary: Mark as resolved
      description: Marks the specified event as resolved
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      - in: path
        name: event_id
        description: Event to use
        required: true
        schema:
          type: string
      - in: query
        name: force
        description: Force adding labels, even if it exists
        schema:
          type: boolean
          default: false
      - in: query
        name: handle_similar_events
        description: Change the labels on all similar events
        schema:
          type: boolean
          default: true
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /services/{env_id}/labels:
    get:
      tags:
      - Labels
      summary: List labels
      description: List all existing labels
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of labels
          content:
            '*/*':
              schema:
                type: object
                properties:
                  labels:
                    type: array
                    items:
                      $ref: '#/components/schemas/Label'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
    post:
      tags:
      - Labels
      summary: Create new label
      description: Create a new label. Labels are used to tag events with custom classifications. Labels help support use cases such as classifying an event as severe / regressed, assign it to a specific developer or team (e.g prod-team-A) or any other user defined categorization.
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Label'
        description: Single label
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '409':
          $ref: '#/components/responses/Conflict'
  /services/{env_id}/events/labels:
    post:
      tags:
      - Labels
      summary: Batch Add/Remove labels
      description: Append/Detach labels to/from events
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      - in: query
        name: force
        description: Force adding labels, even if it exists
        schema:
          type: boolean
          default: false
      - in: query
        name: handle_similar_events
        description: Change the labels on all similar events
        schema:
          type: boolean
          default: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      event_id:
                        type: string
                        example: 42
                      add:
                        type: array
                        items:
                          type: string
                          example: Critical
                      remove:
                        type: array
                        items:
                          type: string
                          example: Low
        description: list of events and label names to append/detach
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
  /services/{env_id}/events/{event_id}/labels:
    post:
      tags:
      - Labels
      summary: Add/Remove labels
      description: Append and remove label(s) from an event
      parameters:
      - in: path
        name: env_id
        description: Environment ID to use (e.g. S1234)
        required: true
        schema:
          type: string
      - in: path
        name: event_id
        description: Event to use
        required: true
        schema:
          type: string
      - in: query
        name: force
        description: Force adding labels, even if it exists
        schema:
          type: boolean
          default: false
      - in: query
        name: handle_similar_events
        description: Change the labels on all similar events
        schema:
          type: boolean
          default: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                add:
                  type: array
                  items:
                    type: string
                    example: Critical
                remove:
                  type: array
                  items:
                    type: string
                    example: Low
        description: list of label names to add / remove
      responses:
        '200':
          $ref: '#/components/responses/OK'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  responses:
    Conflict:
      description: Conflict
    BadRequestError:
      description: Bad Request
    UnauthorizedError:
      description: Unauthorized
    OK:
      description: OK
    NotFoundError:
      description: Not Found
  schemas:
    Label:
      type: object
      properties:
        name:
          type: string
          example: HighPriority
        type:
          type: string
          enum:
          - DEFAULT
          - USER
          example: USER
        color:
          type: string
          example: RED
        created_on:
          type: string
          description: Label creation time. Date in ISO8601 format (yyyy-MM-ddTHH:mm:ss.SSSZ)
          example: '2018-02-28T22:47:09.038Z'
        created_by:
          type: string
          description: View creator
          example: John Doe
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY