---
title: "Batch downtime"
method: POST
path: "/downtime/batch"
tags: ["downtime"]
---

# Batch downtime

`POST /downtime/batch`

## Request

- Base URL: `https://app.torgix.ai/v1`
- URL: `https://app.torgix.ai/v1/downtime/batch`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.torgix.ai/oauth/authorize`, token URL `https://app.torgix.ai/oauth/token`, scopes: `write`)

Up to 200 operations in one call; each item reports its own status. This resource accepts `create` operations only; an `update` item returns 405.

## Request body

- BatchRequest
  - `operations` object[], required
    - `method` 'create' | 'update'
    - `id` integer: Required for update.
    - `data` object

## Response `200`

Per-item results.

- BatchResponse
  - `results` object[]
    - `status` integer
    - `data` object
    - `error` Error
      - `error` object
        - `code` string
        - `message` string
        - `field` string, nullable
        - `request_id` string
  - `request_id` string

## Other responses

- `400`: Malformed request: bad JSON, empty body, bad batch, bad id, or an invalid metric or group_by.
- `401`: Missing or invalid credentials.
- `403`: API access not enabled for the account, missing scope, or IP not allowlisted.
- `422`: The write was rejected (e.g. a required field is missing); `field` names the column.
- `429`: Per-second rate limit exceeded.

---

[API](https://skmtc.dev/torgix/apis/torgix-api.md) · [All operations](https://skmtc.dev/torgix/apis/torgix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/torgix/apis/torgix-api/revisions/e675a45c026d?raw)