# Suspends an active announcement, halting its delivery to target computers

Suspends an active announcement, halting its delivery to target computers. Accepts an optional 'orgin' query parameter to indicate the source of the suspension action.

## Endpoint

`PUT /dcapi/tools/announcement/{collectionId}/suspend`

## Request URL

`https://`[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/dcapi/tools/announcement/{collectionId}/suspend`

### Scope

`DesktopCentralCloud.Tools.UPDATE`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** (`string`, Mandatory): `application/collectionSuspendStatus.v1+json`

### Path Parameters

- **collectionId** (`string`, Mandatory): The unique identifier of the system tools collection

### Query Parameters

- **orgin** (`string`, Optional): Optional

## Sample Request

```curl
curl --request PUT \
  --url https://appdomains/dcapi/tools/announcement/{collectionId}/suspend \
  --header 'Accept: application/collectionSuspendStatus.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body: application/json

- JSON Object
  - **status** (`string`): Result of the operation: success or failure

## Possible Response Codes

- **200** (`HTTP code`)

## Sample Response: HTTP 200

```json
{
  "status": "success"
}
```

## Rate Limits

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.