Ceevee
CeeveeDocs
⌘K
DashboardAPI keysSign up

Get started

  • Introduction
  • Authentication
  • Errors
  • Pagination
  • Versioning

Core resources

  • Jobs
  • Scans (CVs)
  • Candidates
  • Pipeline & stages
  • Assessments
  • Applications

Webhooks

  • Overview
  • Events
  • Signatures

Reference

  • Rate limits
  • Idempotency
  • OpenAPI spec
  • Changelog

API Reference

Pipeline & stages

Manage the Kanban board: stages, ordering, and candidate moves.

Stage moves

Moves are idempotent — re-posting the same stage_id for a candidate is a no-op. Each successful move records the actor user and emits candidate.stage_changed.

curl -X POST \
  https://api.ceevee.cc/v1/jobs/$job_id/candidates/$candidate_id/move \
  -H 'Authorization: Bearer ceevee_sk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{ "stage_id": "stg_…" }'

REST endpoints

GET/v1/jobs/{id}/stages
List a job's pipeline stages, ordered by position.
pipeline:read
POST/v1/jobs/{id}/stages
Add a new stage. position defaults to last.
pipeline:write
PATCH/v1/stages/{id}
Rename a stage or update its colour.
pipeline:write
DELETE/v1/stages/{id}
Delete a stage. Built-in stages cannot be deleted.
pipeline:write
POST/v1/stages/{id}/reorder
Move a stage to a new position in the pipeline.
pipeline:write
POST/v1/jobs/{id}/candidates/{candidate_id}/move
Move a candidate to a target stage.
pipeline:write