---
title: "Check if there are interrogation requests queued for fulfillment"
method: POST
path: "/v2/interrogate/pop"
tags: ["v2"]
---

# Check if there are interrogation requests queued for fulfillment

`POST /v2/interrogate/pop`

This endpoint is used by registered workers only

## Headers

- `apikey` string, required
- `X-Fields` string, mask

## Request body

- InterrogationPopInput
  - `name` string — The Name of the Worker.
  - `priority_usernames` string[]
  - `forms` string[]
  - `amount` integer — The amount of forms to pop at the same time.
  - `bridge_agent` string — The worker name, version and website.
  - `threads` integer — How many threads this worker is running. This is used to accurately the current power available in the horde.
  - `max_tiles` integer — The maximum amount of 512x512 tiles this worker can post-process.

## Response `200`

Interrogation Popped

- InterrogationPopPayload
  - `forms` InterrogationPopFormPayload[]
    - `id` string — The UUID of the interrogation form. Use this to post the results in the future.
    - `form` 'caption' | 'interrogation' | 'nsfw.' | 'GFPGAN' | 'RealESRGAN_x4plus' | 'RealESRGAN_x2plus' | 'RealESRGAN_x4plus_anime_6B' | 'NMKD_Siax' | '4x_AnimeSharp' | 'CodeFormers' | 'strip_background' — The name of this interrogation form
    - `payload` ModelInterrogationFormPayloadStable
      - `*` object
    - `source_image` string — The URL From which the source image can be downloaded.
    - `r2_upload` string — The URL in which the post-processed image can be uploaded.
  - `skipped` NoValidInterrogationsFound
    - `worker_id` integer — How many waiting requests were skipped because they demanded a specific worker.
    - `untrusted` integer — How many waiting requests were skipped because they demanded a trusted worker which this worker is not.
    - `bridge_version` integer — How many waiting requests were skipped because they require a higher version of the bridge than this worker is running (upgrade if you see this in your skipped list).

## Other responses

- `400` — Validation Error
- `401` — Invalid API Key
- `403` — Access Denied

---

[API](https://skmtc.net/haidra-org/apis/ai-horde.md) · [All operations](https://skmtc.net/haidra-org/apis/ai-horde/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haidra-org/ai-horde/versions/dfeb0bedd935/schema)