Help center
https://api.certo.bio/v1openapi.json
Withdraw an ask
POST
/v1/access-requests/{id}/withdrawscope hiring:askWithdraws an open ask; its credit comes back once. An answered ask stays as answered (access_request.decided). The holder is not told.
As an MCP tool: withdraw_access_request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | The ask. |
Response fields
- access_request
- object. The ask, withdrawn.
- access_request.id
- uuid. The ask.
- access_request.passport_url
- string. The passport asked about.
- access_request.name
- string or null. The passport's display name.
- access_request.status
- one of open, approved, declined, expired, withdrawn. open, approved, declined, expired or withdrawn.
- access_request.position_id
- uuid or null. Its position.
- access_request.candidate_id
- uuid or null. The grant once approved.
- access_request.custom_data
- object or null. Your own data on the ask, as you sent it; null for none.
- access_request.created_at
- string. When it was made.
- access_request.expires_at
- string or null. When it expires unanswered.
- credit_returned
- boolean. Whether a credit came back now (false for a free ask, or one withdrawn before).
Errors
- 404 access_request.not_found
- 409 access_request.decided
- 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