{"_id":"59de6011debd1200240f6900","user":"547504ed59fade080004cb8b","__v":6,"category":{"_id":"59de6011debd1200240f68fa","project":"59de6011debd1200240f68ec","version":"59de6011debd1200240f68ee","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-19T01:01:16.044Z","from_sync":false,"order":2,"slug":"endpoints","title":"Applicant Management"},"version":{"_id":"59de6011debd1200240f68ee","__v":2,"project":"59de6011debd1200240f68ec","createdAt":"2016-06-20T18:15:42.514Z","releaseDate":"2016-06-20T18:15:42.514Z","categories":["59de6011debd1200240f68fb","59de6011debd1200240f68fa","59de6011debd1200240f68fc","59de6011debd1200240f68f8","59de6011debd1200240f68f7","59de6011debd1200240f68f9","59de6011debd1200240f68fd","59de6011debd1200240f68fe","59de6011debd1200240f68ff","5a8bfb99f4146e00449cec47","5a8bfcf2e86f530012159bb2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"parentDoc":null,"project":"59de6011debd1200240f68ec","githubsync":"","updates":["58953f5ff401510f0049f573"],"next":{"pages":[],"description":""},"createdAt":"2017-01-20T17:26:50.266Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"curl -X PUT -H 'Content-Type: application/json' -d '{\"skip_automated_action\":\"true\",\"api_token\":\"secret-api-token\"}' 'https://api.fountain.com/v2/applicants/:applicant_id/advance'"}]},"method":"put","results":{"codes":[{"status":204,"language":"json","code":"{ }","name":""},{"status":401,"language":"json","code":"{\n  \"message\": \"Authentication is required\"\n}","name":""}]},"settings":"","auth":"required","params":[{"_id":"56ca916f6b58fb0b00c6d30f","ref":"","in":"body","required":false,"desc":"Required if api_token is not passed in header","default":"secret-api-token","type":"string","name":"api_token"},{"_id":"56c66fe970e7660d004a897e","ref":"","in":"body","required":false,"desc":"Set `true` if you want to skip automated actions when advancing the applicant","default":"false","type":"boolean","name":"skip_automated_actions"},{"_id":"597722b7aefa6c001a81376e","ref":"","in":"body","required":false,"desc":"Destination stage's external id. If not provided, the applicant will advance to the next stage by default.","default":"dc1fe619-2842-4a32-a2b5-0a6c53bfd7e2","type":"string","name":"stage_id"},{"_id":"5a588a3afe845d001253e8e9","ref":"","in":"path","required":true,"desc":"An applicant's UUID","default":"22222222-0000-0000-0000-000000000000","type":"string","name":"id"}],"url":"/applicants/:id/advance"},"isReference":false,"order":7,"body":"This method moves an applicant to an appropriate stage if specified or to the next stage by default.\n\nAll automated actions associated with the target stage are invoked by default.\n\nYou can skip the automated actions using the `skip_automated_actions` parameter set to `\"true\"`.","excerpt":"","slug":"advance-an-applicant","type":"endpoint","title":"Advance an Applicant"}

putAdvance an Applicant


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string22222222-0000-0000-0000-000000000000
An applicant's UUID

Body Params

api_token:
stringsecret-api-token
Required if api_token is not passed in header
skip_automated_actions:
booleanfalse
Set `true` if you want to skip automated actions when advancing the applicant
stage_id:
stringdc1fe619-2842-4a32-a2b5-0a6c53bfd7e2
Destination stage's external id. If not provided, the applicant will advance to the next stage by default.

Examples


Result Format


Documentation

This method moves an applicant to an appropriate stage if specified or to the next stage by default. All automated actions associated with the target stage are invoked by default. You can skip the automated actions using the `skip_automated_actions` parameter set to `"true"`.

User Information

Try It Out

put
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}