Change pipeline stage

POST

https://api.confirm.global/api/v1/applications/:applicationId/change-stage

POST

/api/v1/applications/:applicationId/change-stage

$ curl -X POST https://api.confirm.global/api/v1/applications/applicationId/change-stage \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "to_stage": "applied"
> }'

1 {
2   "success": true,
3   "application": {
4     "application_id": "string",
5     "org_id": "string",
6     "candidate_id": "string",
7     "job_id": "string",
8     "status": "applied",
9     "score": 1.1,
10     "applied_at": "2024-01-15T09:30:00Z",
11     "evaluation_status": "string",
12     "evaluation_sent_at": "2024-01-15T09:30:00Z",
13     "evaluation_completed_at": "2024-01-15T09:30:00Z",
14     "candidates": {
15       "candidate_id": "string",
16       "org_id": "string",
17       "first_name": "string",
18       "last_name": "string",
19       "email": "string",
20       "phone": "string",
21       "address_line1": "string",
22       "address_line2": "string",
23       "city": "string",
24       "state": "string",
25       "postal_code": "string",
26       "country": "string",
27       "source": "string",
28       "applications": [
29         null
30       ],
31       "created_at": "2024-01-15T09:30:00Z",
32       "updated_at": "2024-01-15T09:30:00Z"
33     },
34     "created_at": "2024-01-15T09:30:00Z",
35     "updated_at": "2024-01-15T09:30:00Z"
36   },
37   "stageChange": {
38     "from": "string",
39     "to": "string"
40   }
41 }

Moves the application to a specific pipeline stage. The transition is validated against the workflow; pass force to bypass transition rules.

Authentication

AuthorizationBearer

Supabase-issued user JWT. Send as Authorization Bearer header. Dedicated API keys are planned for a future release.

Path parameters

applicationIdstringRequiredformat: "uuid"

Request

This endpoint expects an object.

to_stageenumRequired

Pipeline stage slug (candidate lifecycle v4).

reasonstringOptional

notestringOptional

forcebooleanOptional

Bypass workflow transition validation.

Response

Transition result.

successbooleanOptional

applicationobjectOptional

stageChangeobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error