Update an application

PATCH

https://api.confirm.global/api/v1/applications/:applicationId

PATCH

/api/v1/applications/:applicationId

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

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

Updates application fields. Passing a stage performs a workflow stage transition and validates it against the organization's pipeline 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.

stageenumOptional

Pipeline stage slug (candidate lifecycle v4).

reasonstringOptional

tagslist of stringsOptional

notesstringOptional

Response

The updated application.

applicationobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error