---
title: "Create a trigger key"
method: POST
path: "/api/jobs/{id}/api-keys"
tags: ["Trigger Keys"]
---

# Create a trigger key

`POST /api/jobs/{id}/api-keys`

Create a new API trigger key for a job. The plain key is returned only once — store it securely.

## Request body

- object
  - `name` string, required — Human-readable name for the trigger key
  - `expiresIn` integer — Optional expiration duration in seconds

## Response `201`

Trigger key created. Store the `key` value securely — it cannot be retrieved again.

- object
  - `success` boolean
  - `apiKey` object
    - `id` string, uuid
    - `name` string
    - `key` string — Plain key value (shown only once)
    - `start` string
    - `enabled` boolean
    - `expiresAt` string, date-time, nullable
    - `createdAt` string, date-time

## Other responses

- `401` — Authentication required or token invalid
- `404` — Resource not found

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)