Talent network
Re-enable off-market candidates for ParaAI matching
curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/re-enable" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"candidates": [
{
"candidateUserId": "string"
}
]
}'
{
"results": [
{
"index": 0,
"ok": true,
"status": "on_market"
}
]
}
Required scopes:
Rate limit:
talent_network:writeRate limit:
write tier, 60 requests per minute per keycandidateUserId, or by email / linkedinUrl (candidateUserId wins; otherwise linkedinUrl beats email, as in lookup). An identity reference acts on every membership row your agency holds for that person; candidateUserIds lists the rows considered.
results is index-aligned with candidates; a well-formed request always answers 200, so branch on per-item ok. status values: on_market (matching resumed), already_on_market (nothing to do), locked (Paraform locked this candidate off market; only a role submission restores eligibility), not_reenableable (the candidate is not in ParaAI consideration — never submitted, or previously excluded — so a fresh submit is the way to put them on the market), and not_found (no candidate owned by an approved member of your agency matches this reference, indistinguishable from a candidate that does not exist). Statuses are never renamed but new ones may be added — branch on ok and treat an unknown status as informational.
Unlike /talent-network/candidates/off-market, this endpoint never requires the Talent Network management entitlement: candidates fall off-market via automated expiry for every agency, so recovering them must always work. Retries converge on already_on_market, so no Idempotency-Key is needed.
Body
object[]
required
Response
object[]
required
curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/re-enable" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"candidates": [
{
"candidateUserId": "string"
}
]
}'
{
"results": [
{
"index": 0,
"ok": true,
"status": "on_market"
}
]
}
⌘I
curl -X POST "https://external-api.paraform.com/api/external/v1/talent-network/candidates/re-enable" \
-H "Authorization: Bearer $PARAFORM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"candidates": [
{
"candidateUserId": "string"
}
]
}'
{
"results": [
{
"index": 0,
"ok": true,
"status": "on_market"
}
]
}