https://api.certo.bio/v1openapi.json

Reopen a position

POST/v1/positions/{id}/reopenscope hiring:write

Opens a closed position again.

As an MCP tool: reopen_position

Path parameters

NameTypeRequiredDescription
iduuidYesThe position.

Response fields

position
object. The position.
position.id
uuid. The position's id.
position.title
string. Its title.
position.location
string or null. Where the work is.
position.status
one of open, closed. open, or closed (kept with its candidates; it only leaves the invite picker).
position.counts
object. How far the position is.
position.counts.invited
integer. Invitations and asks under the position.
position.counts.accepted
integer. Of those, accepted or approved.
position.counts.ready
integer. Candidates under it whose checklist is complete.
position.custom_data
object or null. Your own data on the position, as you sent it; null for none.
position.created_at
string. When it was made, ISO 8601.
scope_types
array of string. What invitations to it ask to share; empty for everything.
include_contact
boolean. Invitations ask for contact details.
include_birth_date
boolean. Invitations ask for the date of birth.
requirements
object or null. What the candidate must have ready; null for the defaults.

Errors

  • 404 position.not_found
  • 409 api.idempotency_mismatch
  • 409 api.idempotency_in_progress
  • 400 api.credential_in_url
  • 401 api.key_invalid
  • 401 api.key_expired
  • 401 api.key_revoked
  • 401 api.key_suspended
  • 403 api.scope_missing
  • 429 api.rate_limited