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

FeldTypPflichtBeschreibung
idintegerOptionalUnique entry ID in the Talent Pool
candidate_idintegerOptionalCandidate ID
candidateobjectOptional{ id, first_name, last_name, email, current_job_title }
ratinginteger|nullOptionalRating 1–5 stars
tagsarrayOptionalCategorization tagsz.B. ["A320 Rated", "Available Q3"]
notesstring|nullOptionalInternal note on the entry
added_atdatetimeOptionalTime 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.
FeldTypPflichtBeschreibung
candidate_idintegerPflichtCandidate ID (must have applied at the tenant)
ratingintegerOptionalRating 1–5 stars
tagsarrayOptionalArray of tag strings
notesstringOptionalInternal 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."
}