Archive (reject) application
Reject an application with an archive reason, an optional note and an optional rejection email.
POST https://cotlet.dev/api/v1/ashby/applications/{application_id}/archive
write Confirm
Archives the application for that job only and moves the candidate to the Archived stage, like Archive in Ashby. The reason must be one from list_archive_reasons. A rejection email goes out only if you name a template, immediately or at the time you set. Other applications of the same candidate stay active. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| application_id string required | string | Application ID from list_applications or get_candidate. |
| archive_reason string required | string | Reason name from list_archive_reasons. |
| note string | string | Optional note stored with the archive reason. |
| email_template string | string | Rejection email template from list_email_templates. Without it no email is sent. |
| send string | string | 'immediately' or 'scheduled'. Default: immediately. With 'scheduled', set send_at. |
| send_at string | string | ISO 8601 date and time with offset, only with send set to scheduled. |
Request
curl -X POST https://cotlet.dev/api/v1/ashby/applications/7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742/archive \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"archive_reason":"Not a fit","note":"About 1 year of backend work; the role asks for 3 or more.","email_template":"After screen","send":"immediately"}'result = client.call("ashby", "archive_application", {"application_id":"7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742","archive_reason":"Not a fit","note":"About 1 year of backend work; the role asks for 3 or more.","email_template":"After screen","send":"immediately"})const result = await cotlet.call('ashby', 'archive_application', {"application_id":"7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742","archive_reason":"Not a fit","note":"About 1 year of backend work; the role asks for 3 or more.","email_template":"After screen","send":"immediately"});cotlet call ashby archive_application --data '{"application_id":"7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742","archive_reason":"Not a fit","note":"About 1 year of backend work; the role asks for 3 or more.","email_template":"After screen","send":"immediately"}'Example response
{
"application_id": "7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742",
"status": "Archived",
"archive_reason": "Not a fit",
"note_added": true,
"rejection_email": {
"template": "After screen",
"status": "sent"
}
}