---
title: "Initiate an Asynchronous request to interrogate an image"
method: POST
path: "/v2/interrogate/async"
tags: ["v2"]
---

# Initiate an Asynchronous request to interrogate an image

`POST /v2/interrogate/async`

This endpoint will immediately return with the UUID of the request for interrogation.
This endpoint will always be accepted, even if there are no workers available currently to fulfill this request.
Perhaps some will appear in the next 20 minutes.
Asynchronous requests live for 20 minutes before being considered stale and being deleted.

## Headers

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

## Request body

- ModelInterrogationInputStable
  - `forms` ModelInterrogationFormStable[]
    - `name` 'caption' | 'interrogation' | 'nsfw' | 'GFPGAN' | 'RealESRGAN_x4plus' | 'RealESRGAN_x2plus' | 'RealESRGAN_x4plus_anime_6B' | 'NMKD_Siax' | '4x_AnimeSharp' | 'CodeFormers' | 'strip_background', required — The type of interrogation this is.
    - `payload` ModelInterrogationFormPayloadStable
      - `*` object
  - `source_image` string — The public URL of the image to interrogate.
  - `slow_workers` boolean — When True, allows slower workers to pick up this request. Disabling this incurs an extra kudos cost.
  - `webhook` string — Provide a URL where the AI Horde will send a POST call after each delivered generation. The request will include the details of the job as well as the request ID.

## Response `202`

Interrogation Queued

- RequestInterrogationResponse
  - `id` string — The UUID of the request. Use this to retrieve the request status in the future.
  - `message` string — Any extra information from the horde about this request.

## Other responses

- `400` — Validation Error
- `401` — Invalid API Key
- `429` — Too Many Prompts
- `503` — Maintenance Mode

---

[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)