> ## Documentation Index
> Fetch the complete documentation index at: https://docs.techforgeinnovate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Jobs

> Requeue one or more existing jobs by UUID.

# Trigger Jobs

Pushes existing jobs back onto the worker queue by UUID.

## Request body

<ParamField body="ids" type="string[]" required>
  Array of job UUID strings to requeue.
</ParamField>

Expected JSON shape:

```json theme={null}
{
  "ids": [
    "15a6331b-3837-4ae8-8fa7-d3ead3388d77",
    "4bc42c50-3206-44d5-a194-d4feeff2b3c0"
  ]
}
```

## Example request

```bash theme={null}
curl -X POST "https://api.techforgeinnovate.com/jobs/trigger-job" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $TFI_API_KEY" \
  -d '{
    "ids": [
      "15a6331b-3837-4ae8-8fa7-d3ead3388d77",
      "4bc42c50-3206-44d5-a194-d4feeff2b3c0"
    ]
  }'
```

## Response

Successful response:

```json theme={null}
{
  "message": "Job triggered"
}
```

If any supplied ID does not resolve to an existing job, the controller stops and returns:

```json theme={null}
{
  "message": "No job found"
}
```

## Status codes

* `201 Created` when the trigger request succeeds
* `401 Unauthorized` when the key is missing or invalid