---
title: "DELETE /portals/{portalId}"
method: DELETE
path: "/portals/{portalId}"
---

# DELETE /portals/{portalId}

`DELETE /portals/{portalId}`

Deletes a portal from IoT SiteWise Monitor.

## Path parameters

- `portalId` string, required

## Query parameters

- `clientToken` string

## Response `202`

Success

- DeletePortalResponse
  - `portalStatus` object, required — The status of the portal, which contains a state (<code>DELETING</code> after successfully calling this operation) and any error message.
    - `state` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'FAILED', required — The current state of the portal.
    - `error` object — Contains associated error information, if any.
      - `code` 'INTERNAL_FAILURE' | 'VALIDATION_ERROR' | 'LIMIT_EXCEEDED' — The error code.
      - `message` string — The error message.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — InternalFailureException
- `483` — ThrottlingException
- `484` — ConflictingOperationException

---

[API](https://skmtc.net/aws/apis/iotsitewise.md) · [All operations](https://skmtc.net/aws/apis/iotsitewise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotsitewise/revisions/d13e5d3e0a6f/schema)