> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asobeast.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pause, resume or untrack many tracked keywords

> Applies one action to up to 500 keyword ids of the app in one write request. pause and resume change the active flag, untrack stops tracking and keeps the ranking history rules of a single removal. changed counts the rows this request changed, unchanged the tracked rows already in the requested state, and missing the ids the app does not track. A resume is all or nothing: it answers 403 with the plan keyword limit and writes nothing when it would pass the limit, and a resumed keyword is checked for its first position within minutes like a new one.



## OpenAPI

````yaml /api-reference/openapi.json post /apps/{id}/keywords/bulk
openapi: 3.0.0
info:
  title: asobeast 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.14.0
  contact: {}
servers:
  - url: http://localhost:3000/api/backend
    description: Web origin proxy
  - url: http://localhost:4000
    description: Direct API
security:
  - personalApiToken: []
tags: []
paths:
  /apps/{id}/keywords/bulk:
    post:
      tags:
        - keywords
      summary: Pause, resume or untrack many tracked keywords
      description: >-
        Applies one action to up to 500 keyword ids of the app in one write
        request. pause and resume change the active flag, untrack stops tracking
        and keeps the ranking history rules of a single removal. changed counts
        the rows this request changed, unchanged the tracked rows already in the
        requested state, and missing the ids the app does not track. A resume is
        all or nothing: it answers 403 with the plan keyword limit and writes
        nothing when it would pass the limit, and a resumed keyword is checked
        for its first position within minutes like a new one.
      operationId: KeywordsController_bulk
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KeywordBulkDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    KeywordBulkDto:
      type: object
      properties:
        action:
          enum:
            - pause
            - resume
            - untrack
          type: string
        keywordIds:
          minItems: 1
          maxItems: 500
          type: array
          items:
            type: string
            maxLength: 64
      required:
        - action
        - keywordIds
  securitySchemes:
    personalApiToken:
      scheme: bearer
      bearerFormat: asob
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.