Jobiflow LogoAPI Docs
ApiCandidates

Remove an imported candidate

Removes a company-imported candidate from your pipeline. This does not affect candidates who applied through Jobiflow directly. Requires scope: `candidates:write`

DELETE
/public/v1/candidates/import/{jobseekerId}

Removes a company-imported candidate from your pipeline. This does not affect candidates who applied through Jobiflow directly.

Requires scope: candidates:write

Authorization

ApiKeyAuth
X-API-Key<token>

API key issued by Jobiflow. Pass it in the X-API-Key request header.

Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.

In: header

Path Parameters

jobseekerId*string

UUID of the imported candidate to remove.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/public/v1/candidates/import/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "status": 401,
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}
{
  "status": 403,
  "error": "FORBIDDEN",
  "message": "Scope 'jobs:write' is required",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}
{
  "status": 404,
  "error": "NOT_FOUND",
  "message": "Job listing not found",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings/00000000-0000-0000-0000-000000000000"
}

Import a candidate POST

Adds an external candidate into your company's pipeline without them having a Jobiflow account. Imported candidates are only visible to your company. Requires scope: `candidates:write`

List webhook subscriptions GET

Returns all webhook subscriptions registered for your company. Requires scope: `webhooks:manage`