forbidden. See also the shared tools (get_profile, update_profile, list_matches, get_rate_limits, ping).
post_role
Post a new open role. Charges 5 credits ($5) from your credit balance; fails withinsufficient_balance (and charges nothing) if the balance is short. The role expires 30 days after posting.
update_role).
update_role
Edit fields of an open role you own. Omitted fields unchanged; same field rules aspost_role. Editing is free.
Returns the updated role.
Rate limits: role_write (20/day, shared with post_role).
close_role
Close an open role you own. It leaves search and the public index, and its matches drop from both sides’ lists. Paid unlocks survive. Irreversible — reopening means a freshpost_role.
list_my_roles
All roles you’ve posted — open, closed, and expired — newest first. No inputs. Returns an array of role objects (same shape aspost_role’s result). Watch expires_at here for repost planning.
Rate limits: read (200/hour).
search_seekers
Search Seeker profiles with a freeform keyword query, matched across name, tagline, experience, and what’s-next blobs.contact_email is never returned here — unlock the Seeker, then read it from get_profile. Omit query to browse the most recently joined Seekers.
get_seeker
A Seeker’s full profile, byseeker_id or @handle (with or without the leading @ — provide exactly one of the two). contact_email is included only if you have unlocked this Seeker — otherwise null.
express_interest_in_seeker
Express interest in a Seeker (byseeker_id or @handle) for one of your open roles. Interest is always role-scoped. Idempotent.
withdraw_interest_in_seeker
Withdraw your Organization’s interest in a Seeker (byseeker_id or @handle) for one of your roles. If the Seeker had expressed interest back, the match dissolves for both of you; the Seeker’s interest is untouched, so re-expressing interest re-forms the match. A paid unlock is unaffected — it survives. Returns not_found if you had no interest in that Seeker for that role.
string (uuid)
Provide exactly one of
seeker_id or handle.string
The Seeker’s public
@handle, with or without the leading @. Provide exactly one of seeker_id or handle.string (uuid)
required
Must be an open role you own.
list_interested_seekers
Seekers who have expressed interest in one of your roles, as profile summaries. Newest first.list_seeker_interests
The Seekers you have expressed interest in — your outbound pipeline — as profile summaries, each tagged with the role it was expressed for and astatus of matched (the Seeker reciprocated) or pending. Only interests on your currently open roles. Newest first.
string (uuid)
Optional. Filter to a single one of your open roles;
not_found if it isn’t an open role you own.contact_email is never included here; unlock a matched Seeker to reveal it.
Rate limits: list (60/hour).
unlock_seeker
Unlock a matched Seeker’s contact email, byseeker_id or @handle (provide exactly one of the two). Charges 1 credit ($1), once, permanently — see unlocks. Requires a current mutual match on at least one open role (not_found otherwise). Idempotent — re-calling returns the existing unlock without charging. Seekers are not notified.
get_profile for that Seeker includes their contact_email.
Rate limits: unlock_seeker (20/day).
get_credit_balance
Your current credit balance in credits (1 credit = $1). A new Organization starts at{ "balance": 20 } from the Early Access welcome grant; it reads 0 once that’s spent and nothing has been purchased. Top up via the dashboard. No inputs.