API reference
Delete a job
DELETE
Deletes the job. By default its reports and interviews are deleted too, which also needs the reports:write scope when the job has reports; credits are never refunded. Send keepReports=true to keep the reports and detach them from the job, which needs only jobs:write. A key acts as its owner, so a member can delete only reports they created (permission_denied otherwise); admins can delete any.
Required scope: jobs:write.
Errors
- 400:
unknown_field - 401:
authentication_required,invalid_api_key - 403:
api_access_disabled,insufficient_scope,permission_denied - 404:
job_not_found - 422:
invalid_parameter - 429:
rate_limit_exceeded - 500:
api_error - 503:
maintenance_mode,service_unavailable
ApiKeyheader
AuthorizationBearer <probb_live_<id>_<secret>>id*stringThe job's ID.
Length
1 <= length <= 200keepReports?stringtrue keeps the job's reports and detaches them. By default they are deleted with their interviews, which also needs the reports:write scope.
Default
"false"Value in
"true""false"Success.
application/json- response
object*stringid*stringdeleted*boolean# Set PROBB_URL and PROBB_API_KEY. Replace any *_VALUE placeholder and any example ID (such as job_example) with a real one.curl --fail-with-body -X DELETE "$PROBB_URL/api/v1/jobs/ID_VALUE" \ -H "Authorization: Bearer $PROBB_API_KEY"Example Response
{ "object": "job", "id": "string", "deleted": true}