Jobs /

Update job health checks

Updates health checks for the given job.

Required permission

Project > Jobs > General > Update

Path parameters

projectId
string required
ID of the project
jobId
string required
ID of the job

Request body

{object}

healthChecks
[array] required
An array of health checks

{object}

protocol
string required
The protocol to access the health check with.
one of
HTTP, CMD
type
string required
The type of health check.
one of
livenessProbe, readinessProbe
path
(multiple options)
The path of the health check endpoint. Required when protocol is HTTP.

string

pattern

^\/([a-zA-Z0-9-._]+\/)*[a-zA-Z0-9-._]+$

cmd
(multiple options)
The command to run for the health check. Required when protocol is CMD

string

port
(multiple options)
Port number for the health check endpoint. Required when protocol is HTTP.

integer

min

initialDelaySeconds
integer required
Initial delay, in seconds, before the health check is first run.
min
1
periodSeconds
integer required
The time between each check, in seconds.
min
1
timeoutSeconds
integer required
min
1
failureThreshold
integer required
The maximum number of allowed failures.
min
1
successThreshold
(multiple options)
The number of successes required to mark the health check as a success.

integer

min

Response body

{object}
Response object.

data
{object} required
Result data.

API

CLI

JS Client

POST /v1/projects/{projectId}/jobs/{jobId}/health-checks

Example request

Request body

curl

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"healthChecks":[{"protocol":"HTTP","type":"readinessProbe","path":"/health-check","port":3000,"initialDelaySeconds":10,"periodSeconds":60,"timeoutSeconds":1,"failureThreshold":3,"successThreshold":1}]}' \
  https://api.northflank.com/v1/projects/{projectId}/jobs/{jobId}/health-checks

Example response

200 OK

The operation was performed successfully.

JSON

{
  "data": {}
}