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

# Check if there are generation requests queued for fulfillment

`POST /v2/generate/text/pop`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v2/generate/text/pop`
- Auth: none declared. Required headers: `apikey`
- TypeScript: <https://skmtc.dev/haidra-org/apis/ai-horde/docs/v2/generate/text/pop/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used by registered workers only

## Headers

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

## Request body

- PopInputKobold
  - `name` string: The Name of the Worker.
  - `priority_usernames` string[]
  - `nsfw` boolean: Whether this worker can generate NSFW requests or not.
  - `models` string[]
  - `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.
  - `require_upfront_kudos` boolean: If True, this worker will only pick up requests where the owner has the required kudos to consume already available.
  - `amount` integer: How many jobvs to pop at the same time
  - `max_length` integer: The maximum amount of tokens this worker can generate.
  - `max_context_length` integer: The max amount of context to submit to this AI for sampling.
  - `softprompts` string[]

## Response `200`

Generation Popped

- GenerationPayload
  - `payload` ModelPayload
    - `prompt` string: The prompt which will be sent to the horde against which to run inference.
    - `n` integer: The amount of images to generate.
    - `seed` string: The seed to use to generete this request.
  - `id` string: The UUID for this generation.
  - `skipped` NoValidRequestFound
    - `worker_id` integer: How many waiting requests were skipped because they demanded a specific worker.
    - `performance` integer: How many waiting requests were skipped because they required higher performance.
    - `nsfw` integer: How many waiting requests were skipped because they demanded a nsfw generation which this worker does not provide.
    - `blacklist` integer: How many waiting requests were skipped because they demanded a generation with a word that this worker does not accept.
    - `untrusted` integer: How many waiting requests were skipped because they demanded a trusted worker which this worker is not.
    - `models` integer: How many waiting requests were skipped because they demanded a different model than what this worker provides.
    - `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).
    - `kudos` integer: How many waiting requests were skipped because the user didn't have enough kudos when this worker requires upfront kudos.

## Other responses

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

---

[API](https://skmtc.dev/haidra-org/apis/ai-horde.md) - [All operations](https://skmtc.dev/haidra-org/apis/ai-horde/llms.txt) - [OpenAPI document](https://skmtc.dev/haidra-org/apis/ai-horde/revisions/dfeb0bedd935?raw)