---
title: "Suspend your application — Anis Developers"
description: "POST /v1/application/suspend stops your own application immediately. Only Anis staff can resume it."
url: https://developers.anis.ly/reference/suspend-application/
language: en
---

> Every page of this documentation: https://developers.anis.ly/llms.txt

[API reference](https://developers.anis.ly/reference.md) · Your application

# Suspend your application

`POST /v1/application/suspend`

POST /v1/application/suspend stops your own application immediately. Only Anis staff can resume it.

- **Permission:** None
- **Authentication:** Signed change
- **Anis’s answer:** Signed
- **Staff-set limits it counts toward:** All requests
- **.NET SDK:** `client.Access.SuspendApplicationAsync(reason)`

- 200 signed answer: `{"applicationId":"<uuid>","status":"suspended","suspendedAt":"<RFC3339>"}`. An already-suspended application returns its current state if the request is admitted; later requests are refused by admission.
- Every stop emails your technical contact. A stop initiated by your team also emails support@anis.ly. If you have lost the private key entirely, contact support@anis.ly.

## Request

Signed with your key, with a one-time nonce and a digest of the body.

Headers: `Signature-Input`, `Signature`, `Content-Digest`, `Nonce`, `X-Anis-Date`. The SDKs set all of them for you.

**Body:** `{"reason":"Suspected compromise"}` — required text, trimmed, 1 to 500 characters. Sign the body digest with a fresh nonce; no Idempotency-Key or scope is required for an admitted request.

## Responses

| Status | Meaning | Body |
| --- | --- | --- |
| 200 | Success. | [ApplicationSuspended](#type-applicationsuspended) |
| 400 | Refused: the signed request is badly built. | [Problem](#refusals) |
| 401 | Refused: not authenticated. | [Problem](#refusals) |
| 403 | Refused: not allowed. | [Problem](#refusals) |
| 404 | Refused: not found, or not yours. | [Problem](#refusals) |
| 409 | Refused: conflicts with the current state. | [Problem](#refusals) |
| 422 | Refused: the request breaks a rule. | [Problem](#refusals) |
| 429 | Refused: a limit was reached. | [Problem](#refusals) |
| 503 | No decision: a dependency was unavailable. | [Problem](#refusals) |

Every answer of this call is signed by Anis — success and every refusal. Require the signature and verify it before you act on the answer; an answer without one is a failure, never an answer ([how](https://developers.anis.ly/docs/verifying-answers.md)).

## Refusals

Every refusal of this call is a signed problem. Branch on its `code`; each links to what it means and what to do.

| Error | Code | Status |
| --- | --- | --- |
| [Invalid credentials](https://developers.anis.ly/errors/invalid-credentials.md) | `invalid_credentials` | 401 |
| [Malformed signed request](https://developers.anis.ly/errors/malformed-signed-request.md) | `malformed_signed_request` | 400 |
| [Source address not allowed](https://developers.anis.ly/errors/source-ip-not-allowed.md) | `source_ip_not_allowed` | 403 |
| [Rate limited](https://developers.anis.ly/errors/rate-limited.md) | `rate_limited` | 429 |
| [Replay detected](https://developers.anis.ly/errors/replay-detected.md) | `replay_detected` | 409 |
| [Validation failed](https://developers.anis.ly/errors/validation-failed.md) | `validation_failed` | 422 |
| [Not found](https://developers.anis.ly/errors/resource-not-found.md) | `resource_not_found` | 404 |
| [Service unavailable](https://developers.anis.ly/errors/dependency-unavailable.md) | `dependency_unavailable` | 503 |
| [Request timeout](https://developers.anis.ly/errors/request-timeout.md) | `request_timeout` | 504 |
| [Internal error](https://developers.anis.ly/errors/internal-error.md) | `internal_error` | 500 |

## Types

### ApplicationSuspended

| Field | Type | Notes |
| --- | --- | --- |
| `applicationId` (required) | UUID | The id of your suspended application. |
| `status` (required) | string | Always `suspended`. Only Anis staff can resume the application. Values: `suspended` |
| `suspendedAt` (required) | string (date-time) | When the application was suspended, as an RFC3339 timestamp. |