AsoBeast Email Alerts API

The email-alerts API from AsoBeast — 6 operation(s) for email-alerts.

Operations 8

GET /email-alerts List configured email alerts #
POST /email-alerts Register an email alert #
PATCH /email-alerts/{id} Update an email alert #
DELETE /email-alerts/{id} Delete an email alert #
POST /email-alerts/{id}/test Send a sample email to a confirmed alert recipient #
POST /email-alerts/{id}/resend-confirmation Send the recipient a new confirmation email #
POST /email-alerts/{id}/confirm Confirm an alert recipient from the link in the confirmation email #
POST /email-alerts/{id}/unsubscribe Stop one email alert from the link in its own message (RFC 8058 one click) #

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/asobeast-com:asobeast-com-email-alerts-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.

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

OpenAPI Specification

asobeast-com-email-alerts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: asobeast Email Alerts API
  description: 'Self hosted ASO toolkit API.


    A metered instance carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset on every response, for the tightest limit the request touched. A self hosted instance has no request rate limits and sends no such header. Limits are per workspace, so minting more tokens does not buy more capacity, and they are sized per plan across three classes: read for stored data, write for configuration changes and store for the endpoints that reach the App Store or Google Play.


    A 429 carries Retry-After and a rateLimit object naming the window that closed, or an aiAllowance object when the workspace has spent the AI calls its plan includes this month. A 403 with a quota object means a plan capacity limit such as apps or tracked keyword markets, which is a different problem from a rate limit. A 402 with an entitlement object means the workspace needs a plan.


    Positions are 1-based and null means checked but not found within the captured depth, never zero. Daily granularity uses UTC dates.'
  version: 1.15.0
  contact: {}
servers:
- url: http://localhost:3000/api/backend
  description: Web origin proxy
- url: http://localhost:4000
  description: Direct API
security:
- personalApiToken: []
tags:
- name: email-alerts
paths:
  /email-alerts:
    get:
      operationId: EmailAlertsController_list
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
      summary: List configured email alerts
      tags:
      - email-alerts
    post:
      operationId: EmailAlertsController_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEmailAlertDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
      summary: Register an email alert
      tags:
      - email-alerts
  /email-alerts/{id}:
    patch:
      operationId: EmailAlertsController_update
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateEmailAlertDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
      summary: Update an email alert
      tags:
      - email-alerts
    delete:
      operationId: EmailAlertsController_remove
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '204':
          description: ''
      summary: Delete an email alert
      tags:
      - email-alerts
  /email-alerts/{id}/test:
    post:
      operationId: EmailAlertsController_test
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
      summary: Send a sample email to a confirmed alert recipient
      tags:
      - email-alerts
  /email-alerts/{id}/resend-confirmation:
    post:
      operationId: EmailAlertsController_resendConfirmation
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      responses:
        '204':
          description: ''
      summary: Send the recipient a new confirmation email
      tags:
      - email-alerts
  /email-alerts/{id}/confirm:
    post:
      operationId: EmailAlertsController_confirm
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: token
        required: true
        in: query
        schema:
          pattern: ^[A-Za-z0-9_-]{43}$
          type: string
      responses:
        '204':
          description: ''
      summary: Confirm an alert recipient from the link in the confirmation email
      tags:
      - email-alerts
  /email-alerts/{id}/unsubscribe:
    post:
      operationId: EmailAlertsController_unsubscribe
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: token
        required: true
        in: query
        schema:
          pattern: ^[A-Za-z0-9_-]{43}$
          type: string
      responses:
        '204':
          description: ''
      summary: Stop one email alert from the link in its own message (RFC 8058 one click)
      tags:
      - email-alerts
components:
  schemas:
    CreateEmailAlertDto:
      type: object
      properties:
        reviewScores:
          type: array
          items:
            type: integer
            enum:
            - 1
            - 2
            - 3
            - 4
            - 5
          example:
          - 1
          - 2
          description: The stars a review.new alert is raised for. Empty or omitted means every star.
        email:
          type: string
          format: email
        events:
          type: array
          minItems: 1
          items:
            type: string
            enum:
            - metadata.changed
            - rank.dropped
            - rank.improved
            - rank.milestone
            - rank.first
            - rank.overtaken
            - review.negative
            - digest.weekly
            - serp.entrant
            - action.opened
            - chart.entered
            - chart.left
            - chart.milestone
            - review.new
        confirmDrops:
          type: boolean
      required:
      - email
      - events
    UpdateEmailAlertDto:
      type: object
      properties:
        reviewScores:
          type: array
          items:
            type: integer
            enum:
            - 1
            - 2
            - 3
            - 4
            - 5
          example:
          - 1
          - 2
          description: The stars a review.new alert is raised for. Empty or omitted means every star.
        email:
          type: string
          format: email
        events:
          type: array
          minItems: 1
          items:
            type: string
            enum:
            - metadata.changed
            - rank.dropped
            - rank.improved
            - rank.milestone
            - rank.first
            - rank.overtaken
            - review.negative
            - digest.weekly
            - serp.entrant
            - action.opened
            - chart.entered
            - chart.left
            - chart.milestone
            - review.new
        active:
          type: boolean
        confirmDrops:
          type: boolean
  securitySchemes:
    personalApiToken:
      scheme: bearer
      bearerFormat: asob
      type: http