Supercheck LogoSupercheck
Trigger Keys

Create a trigger key

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

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

Authorization

bearerAuth
AuthorizationBearer <token>

CLI token (sck_live_*) for full API access, or trigger key (sck_trigger_* / legacy job_*) for job trigger endpoint only.

In: header

Path Parameters

id*string

Job ID

Formatuuid

Request Body

application/json

name*string

Human-readable name for the trigger key

expiresIn?integer

Optional expiration duration in seconds

Response Body

application/json

application/json

application/json

curl -X POST "https://demo.supercheck.dev/api/jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08/api-keys" \  -H "Content-Type: application/json" \  -d '{    "name": "GitHub Actions"  }'
{
  "success": true,
  "apiKey": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "key": "sck_trigger_f1e2d3c4b5a6789012345678901234cd",
    "start": "string",
    "enabled": true,
    "expiresAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "Unauthorized"
}
{
  "error": "Not found"
}