Help center
https://api.certo.bio/v1openapi.json
Reopen a position
POST
/v1/positions/{id}/reopenscope hiring:writeOpens a closed position again.
As an MCP tool: reopen_position
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | The 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