> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/qwantifi-api-and-command-reference/pos-mqtt-api-reference.md).

# POS MQTT API Reference

The complete integrated application-facing endpoint surface for QwantiFi on Postman. These endpoints let an integrated application renew its own QwantiFi credential and look up its devices and topics at runtime. For the concepts and message flow behind them, see the [<mark style="color:red;">**Integration Guide**</mark>](https://developer.magtek.com/guides/guides/qwantifi/pos-integration-guide); for the credential model, see the [<mark style="color:red;">**QwantiFi Credential Model**</mark>](https://developer.magtek.com/guides/guides/qwantifi/qwantifi-credential-model).

{% hint style="info" %}
**Credential issuance is not on this surface.** You must contact MagTek/Magensa support to request them. There is no endpoint you can call to mint yourself a credential or a new refresh token. Everything here assumes you already hold both.
{% endhint %}

### **API Reference - Postman Collections** <a href="#hid-demo" id="hid-demo"></a>

| **API Section**                                                                                                                                            | **Description**                                                                                                                                                                             |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:red;">**QwantiFi Cloud Management**</mark>](https://rmsv2.developer.magtek.com/#919d6207-be9d-41b6-942b-c9dadb1aa66a)                  | Parent group for the RMS cloud-management calls an integrated application or management host uses to configure QwantiFi-connected devices and manage their MQTT settings, keys, and status. |
| [<mark style="color:red;">**Update Device MQTT Configurations**</mark>](https://rmsv2.developer.magtek.com/#ba45f39d-4914-4d45-9861-ce95ccaf54f3)          | Updates the QwantiFi configuration provisioned to a device — its broker connection and topic assignments — in RMS.                                                                          |
| [<mark style="color:red;">**Update Device Status**</mark>](https://rmsv2.developer.magtek.com/#7592ccb9-be75-406c-b0ce-60ec5683f36a)                       | Updates a device's status record in RMS, such as its enrollment or connection state.                                                                                                        |
| [<mark style="color:red;">**Configs/List (DynaFlex)**</mark>](https://rmsv2.developer.magtek.com/#ea2ed49a-4238-4258-8bc1-c15b310e3b66)                    | Returns the list of configuration profiles available for DynaFlex devices.                                                                                                                  |
| [<mark style="color:red;">**Configs Key Load (DynaFlex)**</mark>](https://rmsv2.developer.magtek.com/#9c35c948-2053-4893-a2d3-a5528aeb952c)                | Initiates a key-load configuration for a DynaFlex device, injecting or updating its cryptographic keys.                                                                                     |
| [<mark style="color:$tint;">**Configs Key Load (DynaFlex Force update)**</mark>](https://rmsv2.developer.magtek.com/#1481e7a7-5ed9-4df3-8995-9fabce8ff009) | Re-runs the DynaFlex key-load configuration, forcing it even when the device already reports its keys as current.                                                                           |
| [<mark style="color:red;">**Configs SCDE (DynaFlexIIGo)**</mark>](https://rmsv2.developer.magtek.com/#c2dbc0fd-e6cb-479a-a920-a762ad62dc57)                | Applies the SCDE configuration profile to a DynaFlex II Go device.                                                                                                                          |
| [<mark style="color:red;">**Configs SCDE (DynaFlexIIGo Force update)**</mark>](https://rmsv2.developer.magtek.com/#036f3878-3b5a-4c88-8a48-0923352bed45)   | Re-applies the SCDE configuration to a DynaFlex II Go device, forcing the update even if it is already present.                                                                             |
| [<mark style="color:red;">**QwantiFi Self-Service API**</mark>](https://documenter.getpostman.com/view/33729815/2sBYB1MTR2)                                | Self-service endpoints for a point-of-sale (POS) application that already hold MagTek MQTT credentials.                                                                                     |

### Need More Help

{% hint style="info" %}
**Need Help?**

For additional support, please contact MagTek Support:

**Technical Support:**

* 📧 **Email:** [support@magtek.com](mailto:support@magtek.com?subject=Support%20Request)
* 📞 **Phone:** 1-562-546-6800 (US)
* 🕐 **Hours:** Monday-Friday, 5:30 AM - 5:00 PM PST

**Online Resources:**

* 🌐 **Support Portal:** developer.magtek.com

**Documentation Feedback:**

Help us improve this documentation! [feedback@magtek.com](mailto:feedback@magtek.com?subject=Feedback)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/api-and-command-reference/qwantifi-api-and-command-reference/pos-mqtt-api-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
