---
title: "Decline a challenge"
method: POST
path: "/api/challenge/{challengeId}/decline"
tags: ["Challenges"]
---

# Decline a challenge

`POST /api/challenge/{challengeId}/decline`

Decline an incoming challenge.

## Path parameters

- `challengeId` string, required

## Response `200`

The challenge was successfully declined.

- Ok
  - `ok` boolean, required

## Other responses

- `404` — The challenge to decline was not found.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)