---
title: "Refuse a candidate by its address"
method: POST
path: "/projects/{id}/corroboration-candidates/dismiss"
tags: ["Corroborations"]
---

# Refuse a candidate by its address

`POST /projects/{id}/corroboration-candidates/dismiss`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/projects/{id}/corroboration-candidates/dismiss`
- Auth: HTTP bearer

That page is never proposed again for this project. Nothing is created or deleted, and the
call is idempotent. Manager or above.

## Request body

- object
  - `url` string, uri, required: The address of the candidate, exactly as listed.

## Response `200`

The address now refused.

- object
  - `dismissed` string, required

## Other responses

- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `422`: `invalid_corroboration`: `url` is required.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

[API](https://skmtc.dev/epovest/apis/epovest-api.md) · [All operations](https://skmtc.dev/epovest/apis/epovest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/epovest/apis/epovest-api/revisions/7a78ee27ecbb?raw)