Talent Pool
Manage the Talent Pool — add, rate and remove candidates.
What is the Talent Pool?
The Talent Pool is a curated list of promising candidates who are not actively applying for an open position but are interesting for future roles. Candidates in the Talent Pool can be rated (1–5 stars) and tagged.
Talent Pool Entry Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Optional | Unique entry ID in the Talent Pool |
| candidate_id | integer | Optional | Candidate ID |
| candidate | object | Optional | { id, first_name, last_name, email, current_job_title } |
| rating | integer|null | Optional | Rating 1–5 stars |
| tags | array | Optional | Categorization tagsz.B. ["A320 Rated", "Available Q3"] |
| notes | string|null | Optional | Internal note on the entry |
| added_at | datetime | Optional | Time of addition |
GET /talent-pool — Get Talent Pool
GEThttps://api.aeroselect.io/api/v2/external/talent-pool
cURLBash
curl "https://api.aeroselect.io/api/v2/external/talent-pool?page=1" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{
"data": [
{
"id": 301,
"candidate_id": 55,
"candidate": {
"id": 55,
"first_name": "Max",
"last_name": "Müller",
"email": "[email protected]",
"current_job_title": "First Officer A320"
},
"rating": 5,
"tags": ["A320 Rated", "ATPL", "Available Q3 2026"],
"notes": "Sehr gutes Erstgespräch. Für Captain-Upgrade geeignet.",
"added_at": "2026-04-15T10:30:00Z"
}
],
"meta": { "total": 89, "page": 1, "per_page": 25 }
}POST /talent-pool — Add Candidate
Adds a candidate to the Talent Pool. Requires scope talent_pool:write.
POSThttps://api.aeroselect.io/api/v2/external/talent-pool
Duplicate Protection
If a candidate is already in the Talent Pool, the existing entry is returned instead of throwing an error.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| candidate_id | integer | Pflicht | Candidate ID (must have applied at the tenant) |
| rating | integer | Optional | Rating 1–5 stars |
| tags | array | Optional | Array of tag strings |
| notes | string | Optional | Internal note (max. 2,000 characters) |
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/talent-pool" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"candidate_id": 55,
"rating": 5,
"tags": ["A320 Rated", "ATPL", "Available Q3 2026"],
"notes": "Hervorragender Kandidat für zukünftige Captain-Positionen."
}'DELETE /talent-pool/{id} — Remove Candidate
Removes a candidate from the Talent Pool. Requires scope talent_pool:write.
DELETEhttps://api.aeroselect.io/api/v2/external/talent-pool/{id}
cURLBash
curl -X DELETE "https://api.aeroselect.io/api/v2/external/talent-pool/301" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{
"message": "Candidate removed from talent pool."
}