Docs
API reference

Dismiss queued auto-invite candidates

POST
/api/v1/jobs/{id}/auto-invite/evaluations/dismiss

Takes candidates out of the queue because a person decided not to invite them. Nothing is sent to the candidate, no decision is recorded and the report is untouched. Dismissing an item that is already dismissed changes nothing. An item that was invited or did not match is auto_invite_not_pending.

Required scope: auto_invite:write.

Errors

  • 400: invalid_content_type, invalid_idempotency_key, invalid_json, request_body_too_large, unknown_field
  • 401: authentication_required, invalid_api_key
  • 403: api_access_disabled, insufficient_scope
  • 404: auto_invite_evaluation_not_found, job_not_found
  • 409: auto_invite_not_pending, idempotency_key_reused, idempotency_request_in_progress
  • 422: invalid_parameter
  • 429: rate_limit_exceeded
  • 500: api_error
  • 503: maintenance_mode, service_unavailable

Authorization

ApiKey
headerAuthorizationBearer <probb_live_<id>_<secret>>

Path Parameters

id*string

The job's ID.

Length1 <= length <= 200

Header Parameters

Idempotency-Key?string

Makes retries safe. Repeating a request with the same key and body within 24 hours returns the original response with Idempotent-Replayed: true. The same key with a different body, or from a different API key, returns idempotency_key_reused.

Length1 <= length <= 255

Request Body

application/json
  1. body
evaluationIds*array<>

The evaluations to dismiss, from GET /v1/jobs/{id}/auto-invite/evaluations, at most 100.

Items1 <= items <= 100

Response Body

Success.

application/json
  1. response
object*string
dismissedCount*integer

Items moved from queued to dismissed; ones already dismissed are not counted.

Range-9007199254740991 <= value <= 9007199254740991
Example Request
# Set PROBB_URL and PROBB_API_KEY. Replace any *_VALUE placeholder and any example ID (such as job_example) with a real one.# Idempotency-Key is optional. Reuse the same key and body when retrying one logical write.curl --fail-with-body -X POST "$PROBB_URL/api/v1/jobs/ID_VALUE/auto-invite/evaluations/dismiss" \  -H "Authorization: Bearer $PROBB_API_KEY" \  -H "Idempotency-Key: $REQUEST_KEY" \  -H 'Content-Type: application/json' \  --data-binary '{  "evaluationIds": [    "aie_example_3"  ]}'
Example Response
{  "object": "auto_invite_dismissal",  "dismissedCount": -9007199254740991}