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

# Manage Jobs

> List, retrieve, and delete scheduled jobs

# Manage Jobs

Manage all scheduled jobs created using the LifyGo API.

***

## List Jobs

`GET /jobs`

Returns all scheduled jobs associated with your API key.

```bash theme={null}
curl http://localhost:8080/jobs \
  -H "X-API-Key: lfy_your_key"
```

### Response

```json theme={null}
[
  {
    "id": "job_abc123",
    "name": "weekly-digest",
    "type": "webhook",
    "schedule_type": "cron",
    "cron_expression": "0 9 * * 1",
    "status": "active",
    "created_at": "2026-07-22T09:00:00Z"
  }
]
```

***

## Get a Single Job

`GET /jobs/{id}`

```bash theme={null}
curl http://localhost:8080/jobs/job_abc123 \
  -H "X-API-Key: lfy_your_key"
```

Returns the full configuration for the specified scheduled job.

***

## Delete a Job

`DELETE /jobs/{id}`

Deletes a scheduled job immediately.

```bash theme={null}
curl -X DELETE http://localhost:8080/jobs/job_abc123 \
  -H "X-API-Key: lfy_your_key"
```

### Response

```json theme={null}
{
  "message": "job deleted"
}
```

> Deleted jobs cannot be recovered. Their execution history remains available in the execution logs.