Sentry Discover API

Manage saved Discover queries

Operations 5

GET /organizations/{organization_id_or_slug}/discover/saved/ Sentry List an organization's Discover saved queries #
POST /organizations/{organization_id_or_slug}/discover/saved/ Sentry Create a new saved query #
GET /organizations/{organization_id_or_slug}/discover/saved/{query_id}/ Sentry Retrieve an organization's Discover saved query #
PUT /organizations/{organization_id_or_slug}/discover/saved/{query_id}/ Sentry Edit an organization's Discover saved query #
DELETE /organizations/{organization_id_or_slug}/discover/saved/{query_id}/ Sentry Delete an organization's Discover saved query #

Documentation

Specifications

Schemas & Data

Other Resources

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/sentry-system-discover-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

sentry-system-discover-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Sentry Alerts Discover API
  description: The Alerts API provides endpoints for managing alert rules in Sentry, including creating, retrieving, updating, and deleting metric alert rules and issue alert rules, as well as managing spike protection notification actions.
  version: 0.0.1
  contact:
    name: Sentry Support
    url: https://sentry.io/support/
    email: support@sentry.io
servers:
- url: https://sentry.io/api/0
  description: Sentry Production API
security:
- BearerAuth: []
tags:
- name: Discover
  description: Manage saved Discover queries
paths:
  /organizations/{organization_id_or_slug}/discover/saved/:
    get:
      operationId: listDiscoverSavedQueries
      summary: Sentry List an organization's Discover saved queries
      description: Returns a list of saved Discover queries for the given organization.
      tags:
      - Discover
      parameters:
      - $ref: '#/components/parameters/OrganizationIdOrSlug'
      - name: cursor
        in: query
        description: Pagination cursor.
        schema:
          type: string
      - name: query
        in: query
        description: Search by query name.
        schema:
          type: string
      - name: sortBy
        in: query
        description: Sort by field (e.g., dateCreated, dateUpdated, name).
        schema:
          type: string
      responses:
        '200':
          description: A list of saved queries.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SavedQuery'
        '401':
          description: Unauthorized.
        '403':
          description: Forbidden.
    post:
      operationId: createDiscoverSavedQuery
      summary: Sentry Create a new saved query
      description: Creates a new saved Discover query for the given organization.
      tags:
      - Discover
      parameters:
      - $ref: '#/components/parameters/OrganizationIdOrSlug'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - fields
              properties:
                name:
                  type: string
                  description: The name of the saved query.
                fields:
                  type: array
                  items:
                    type: string
                  description: The fields to select in the query.
                query:
                  type: string
                  description: The Sentry search query.
                projects:
                  type: array
                  items:
                    type: integer
                  description: Project IDs to filter by.
                environment:
                  type: array
                  items:
                    type: string
                  description: Environment names to filter by.
                range:
                  type: string
                  description: Time range (e.g., 24h, 14d, 30d).
                orderby:
                  type: string
                  description: The field to order by.
                version:
                  type: integer
                  description: The Discover query version.
      responses:
        '201':
          description: Saved query created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedQuery'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '403':
          description: Forbidden.
  /organizations/{organization_id_or_slug}/discover/saved/{query_id}/:
    get:
      operationId: retrieveDiscoverSavedQuery
      summary: Sentry Retrieve an organization's Discover saved query
      description: Returns a specific saved Discover query.
      tags:
      - Discover
      parameters:
      - $ref: '#/components/parameters/OrganizationIdOrSlug'
      - $ref: '#/components/parameters/QueryId'
      responses:
        '200':
          description: Saved query details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedQuery'
        '401':
          description: Unauthorized.
        '404':
          description: Saved query not found.
    put:
      operationId: editDiscoverSavedQuery
      summary: Sentry Edit an organization's Discover saved query
      description: Updates a saved Discover query.
      tags:
      - Discover
      parameters:
      - $ref: '#/components/parameters/OrganizationIdOrSlug'
      - $ref: '#/components/parameters/QueryId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                fields:
                  type: array
                  items:
                    type: string
                query:
                  type: string
                projects:
                  type: array
                  items:
                    type: integer
                environment:
                  type: array
                  items:
                    type: string
                range:
                  type: string
                orderby:
                  type: string
      responses:
        '200':
          description: Saved query updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedQuery'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.
        '404':
          description: Saved query not found.
    delete:
      operationId: deleteDiscoverSavedQuery
      summary: Sentry Delete an organization's Discover saved query
      description: Deletes a saved Discover query.
      tags:
      - Discover
      parameters:
      - $ref: '#/components/parameters/OrganizationIdOrSlug'
      - $ref: '#/components/parameters/QueryId'
      responses:
        '204':
          description: Saved query deleted.
        '401':
          description: Unauthorized.
        '404':
          description: Saved query not found.
components:
  parameters:
    QueryId:
      name: query_id
      in: path
      required: true
      description: The ID of the saved query.
      schema:
        type: integer
    OrganizationIdOrSlug:
      name: organization_id_or_slug
      in: path
      required: true
      description: The ID or slug of the organization.
      schema:
        type: string
  schemas:
    SavedQuery:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        fields:
          type: array
          items:
            type: string
        query:
          type: string
        projects:
          type: array
          items:
            type: integer
        environment:
          type: array
          items:
            type: string
        range:
          type: string
          nullable: true
        orderby:
          type: string
        version:
          type: integer
        dateCreated:
          type: string
          format: date-time
        dateUpdated:
          type: string
          format: date-time
        createdBy:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            email:
              type: string
      required:
      - id
      - name
      - fields
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Authentication token for the Sentry API.