For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Resources
Log inGet a demo
Get startedAPI referenceImplementation
Get startedAPI referenceImplementation
    • Overview
          • The Application object
          • GET/applications
          • POST/applications
          • GET/applications/{id}
          • POST/applications/{id}/change-stage
          • GET/applications/meta/post
UnifiedAgent HandlerGateway
UnifiedAgent HandlerGateway
Resources
Log inGet a demo
Common ModelsApplications

/applications/{id}/change-stage

Beta
POST
/ats/v1/applications/:id/change-stage
POST
/api/ats/v1/applications/:id/change-stage
$curl -X POST https://api.merge.dev/api/ats/v1/applications/id/change-stage \
>     -H "X-Account-Token: X-Account-Token" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
201Created
1{
2  "model": {
3    "id": "92e8a369-fffe-430d-b93a-f7e8a16563f1",
4    "remote_id": "98796",
5    "created_at": "2021-09-15T00:00:00Z",
6    "modified_at": "2021-10-16T00:00:00Z",
7    "candidate": "2872ba14-4084-492b-be96-e5eee6fc33ef",
8    "job": "52bf9b5e-0beb-4f6f-8a72-cd4dca7ca633",
9    "applied_at": "2021-10-15T00:00:00Z",
10    "rejected_at": "2021-11-15T00:00:00Z",
11    "offers": [
12      "e9b5c11d-c588-468e-8567-cd6992e42b62"
13    ],
14    "source": "Campus recruiting event",
15    "credited_to": "58166795-8d68-4b30-9bfb-bfd402479484",
16    "screening_question_answers": [
17      {
18        "question": "0238cbc6-6040-430a-848e-aaiehfhdbadf4ae",
19        "answer": "5+ years experience"
20      },
21      {
22        "question": "59982bf6-7c54-4ff8-ab60-ced0bb644b84",
23        "answer": "New york city"
24      }
25    ],
26    "current_stage": "d578dfdc-7b0a-4ab6-a2b0-4b40f20eb9ea",
27    "reject_reason": "59b25f2b-da02-40f5-9656-9fa0db555784",
28    "remote_was_deleted": true,
29    "field_mappings": {
30      "organization_defined_targets": {
31        "custom_key": "custom_value"
32      },
33      "linked_account_defined_targets": {
34        "custom_key": "custom_value"
35      }
36    },
37    "remote_data": [
38      {
39        "path": "/candidacies",
40        "data": null
41      }
42    ]
43  },
44  "warnings": [
45    {
46      "title": "Unrecognized Field",
47      "detail": "An unrecognized field, age, was passed in with request data.",
48      "problem_type": "UNRECOGNIZED_FIELD",
49      "source": {
50        "pointer": "/age"
51      },
52      "block_merge_link": true,
53      "raw_error": "string",
54      "error_code": 1
55    }
56  ],
57  "errors": [
58    {
59      "title": "Missing Required Field",
60      "detail": "custom_fields is a required field on model.",
61      "problem_type": "MISSING_REQUIRED_FIELD",
62      "source": {
63        "pointer": "/model/custom_fields"
64      },
65      "block_merge_link": true,
66      "raw_error": "string",
67      "error_code": 1
68    }
69  ],
70  "logs": [
71    {
72      "log_id": "99433219-8017-4acd-bb3c-ceb23d663832",
73      "dashboard_view": "https://app.merge.dev/logs/99433219-8017-4acd-bb3c-ceb23d663832",
74      "log_summary": {
75        "url": "www.exampleintegration.com/api/v1/exampleapi",
76        "method": "POST",
77        "status_code": 200
78      }
79    }
80  ]
81}

Updates the current_stage field of an Application object

Field support by integration

See all supported fields

Use the /linked-accounts endpoint to pull platform support information

Was this page helpful?
Previous

/applications/{id}

Next

/applications/meta/post

Built with

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

idstringRequiredformat: "uuid"

Headers

X-Account-TokenstringRequired
Token identifying the end user.

Query parameters

is_debug_modebooleanOptional

Whether to include debug fields (such as log file links) in the response.

run_asyncbooleanOptional

Whether or not third-party updates should be run asynchronously.

Request

This endpoint expects an object.
job_interview_stagestring or nullOptionalformat: "uuid"
The interview stage to move the application to.
remote_user_idstringOptional>=1 character

Response

modelobject

Description

The Application Object is used to represent a candidate’s journey through a particular Job’s recruiting process. If a Candidate applies for multiple Jobs, there will be a separate Application for each Job if the third-party integration allows it.

Usage Example

Fetch from the LIST Applications endpoint and filter by ID to show all applications.

warningslist of objects
errorslist of objects
logslist of objects