---
title: "POST /20200301/gateways/{gatewayId}/capability"
method: POST
path: "/20200301/gateways/{gatewayId}/capability"
---

# POST /20200301/gateways/{gatewayId}/capability

`POST /20200301/gateways/{gatewayId}/capability`

Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use <a href="https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeGateway.html">DescribeGateway</a>.

## Path parameters

- `gatewayId` string, required

## Request body

- object
  - `capabilityNamespace` string, required — The namespace of the gateway capability configuration to be updated. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace <code>iotsitewise:opcuacollector:version</code>, where <code>version</code> is a number such as <code>1</code>.
  - `capabilityConfiguration` string, required — The JSON document that defines the configuration for the gateway capability. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html#configure-source-cli">Configuring data sources (CLI)</a> in the <i>IoT SiteWise User Guide</i>.

## Response `201`

Success

- UpdateGatewayCapabilityConfigurationResponse
  - `capabilityNamespace` string, required — The namespace of the gateway capability.
  - `capabilitySyncStatus` 'IN_SYNC' | 'OUT_OF_SYNC' | 'SYNC_FAILED' | 'UNKNOWN', required — <p>The synchronization status of the capability configuration. The sync status can be one of the following:</p> <ul> <li> <p> <code>IN_SYNC</code> – The gateway is running the capability configuration.</p> </li> <li> <p> <code>OUT_OF_SYNC</code> – The gateway hasn't received the capability configuration.</p> </li> <li> <p> <code>SYNC_FAILED</code> – The gateway rejected the capability configuration.</p> </li> </ul> <p>After you update a capability configuration, its sync status is <code>OUT_OF_SYNC</code> until the gateway receives and applies or rejects the updated configuration.</p>

## Other responses

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

---

[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)