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

# Archive webpages

> Archives one or more webpages: monitoring stops and the plan quota slot is freed, but the webpage and all related data (incidents, policies, notification configuration, blackout schedules, verification history) are retained for audit purposes until manually removed.

Archiving moves the webpage out of the monitored states: its health status is set to `Archived` (excluded from the worker scheduler's polling allowlist) and its plan type is set to `ARCHIVED` (excluded from quota counts). An archive record stores when it happened, the previous plan type, and an optional remark.

A single-webpage archive is simply a one-element `url_ids` array.



## OpenAPI

````yaml /openapi.json post /api/v1/urls/batch_archive
openapi: 3.0.3
info:
  title: WebOrion Monitor API
  description: >-
    REST API for managing webpages, alerts, batch jobs, and activity logs in
    WebOrion Defacement Monitor.
  version: '2021-08-31'
servers:
  - url: https://api.monitor.weborion.io
security:
  - bearerAuth: []
tags:
  - name: User
    description: Operations related to user accounts
  - name: Webpages
    description: Operations related to webpages and URLs
  - name: Batch Jobs
    description: Operations related to batch baseline and rebaseline jobs
  - name: Alerts
    description: Operations related to alerts
  - name: Domains
    description: Operations related to domains
  - name: Tags
    description: Operations related to tags for organising webpages
paths:
  /api/v1/urls/batch_archive:
    post:
      tags:
        - Webpages
        - Batch Jobs
      summary: Archive webpages
      description: >-
        Archives one or more webpages: monitoring stops and the plan quota slot
        is freed, but the webpage and all related data (incidents, policies,
        notification configuration, blackout schedules, verification history)
        are retained for audit purposes until manually removed.


        Archiving moves the webpage out of the monitored states: its health
        status is set to `Archived` (excluded from the worker scheduler's
        polling allowlist) and its plan type is set to `ARCHIVED` (excluded from
        quota counts). An archive record stores when it happened, the previous
        plan type, and an optional remark.


        A single-webpage archive is simply a one-element `url_ids` array.
      operationId: batchArchiveUrls
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchArchiveBody'
      responses:
        '200':
          description: OK
components:
  schemas:
    BatchArchiveBody:
      type: object
      required:
        - url_ids
      properties:
        url_ids:
          type: array
          items:
            type: integer
          description: >-
            IDs of the webpages to archive. A single-item array archives one
            webpage.
        remark:
          type: string
          description: Optional note recorded alongside the archive event.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Generate an API token from the WebOrion Defacement Monitor portal. Pass
        it as `Authorization: Bearer <token>`.

````