---
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`

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.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/revisions/dfeb0bedd935/schema)