Measure Prefs API

User notification preferences.

GitHub OpenAPI

Operations 2

GET /prefs/notifPrefs Fetch the current user's notification preferences #
PATCH /prefs/notifPrefs Update the current user's notification preferences #

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/measure-sh:measure-sh-prefs-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

measure-sh-prefs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Measure Dashboard Prefs API
  version: 1.0.0
  description: 'Reference for Measure''s Dashboard REST API. Every endpoint, request body,

    response format and status code.


    Requests are authenticated with the user''s access token in

    `Authorization: Bearer ` format, unless cookies are used to

    send tokens. Set `Content-Type: application/json; charset=utf-8` on each

    request.


    Failed requests have the following response shape:


    ```json

    {

    "error": "Error message",

    "details": "Additional error details, when available"

    }

    ```'
servers:
- url: https://api.measure.sh
  description: Measure cloud
- url: http://localhost:8080
  description: Self-hosted Measure API origin
security:
- bearerAuth: []
tags:
- name: Prefs
  description: User notification preferences.
paths:
  /prefs/notifPrefs:
    get:
      operationId: getNotifPrefs
      tags:
      - Prefs
      summary: Fetch the current user's notification preferences
      description: 'Fetch notification preferences for the current user. These preferences

        control which types of email notifications the user receives.'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                properties:
                  fatal_error_spike:
                    type: boolean
                  anr_app_hang_spike:
                    type: boolean
                  bug_report:
                    type: boolean
                  daily_summary:
                    type: boolean
                  created_at:
                    type: string
                  updated_at:
                    type: string
              examples:
                response:
                  value:
                    fatal_error_spike: true
                    anr_app_hang_spike: true
                    bug_report: true
                    daily_summary: true
                    created_at: '2024-01-01T00:00:00Z'
                    updated_at: '2024-01-01T00:00:00Z'
        '400':
          description: Request is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
        '401':
          description: Either the user's access token is invalid or has expired.
        '403':
          description: Requester does not have access to this resource.
        '429':
          description: Rate limit of the requester has crossed maximum limits.
        '500':
          description: Measure server encountered an unfortunate error. Report this to your server administrator.
    patch:
      operationId: updateNotifPrefs
      tags:
      - Prefs
      summary: Update the current user's notification preferences
      description: 'Update notification preferences for the current user. All four boolean

        fields must be provided in the request body.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - fatal_error_spike
              - anr_app_hang_spike
              - bug_report
              - daily_summary
              properties:
                fatal_error_spike:
                  type: boolean
                anr_app_hang_spike:
                  type: boolean
                bug_report:
                  type: boolean
                daily_summary:
                  type: boolean
            examples:
              request:
                value:
                  fatal_error_spike: true
                  anr_app_hang_spike: true
                  bug_report: false
                  daily_summary: true
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: string
              examples:
                response:
                  value:
                    ok: done
        '400':
          description: Request is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
        '401':
          description: Either the user's access token is invalid or has expired.
        '403':
          description: Requester does not have access to this resource.
        '429':
          description: Rate limit of the requester has crossed maximum limits.
        '500':
          description: Measure server encountered an unfortunate error. Report this to your server administrator.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'User access token issued at sign-in. Sent as

        `Authorization: Bearer <access-token>` unless cookies are used to send

        tokens. The `/auth/refresh` and `/auth/signout` endpoints expect the

        session''s refresh token in the same header format instead.

        '