Revoke a POS sync device
curl --request POST \
--url https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "<string>",
"computer_id": "<string>",
"name": "<string>",
"platform": "<string>",
"status": "<string>",
"last_seen_at": "2023-11-07T05:31:56Z",
"last_reported_state": "<string>",
"last_reported_meta": {},
"credentials_rotated_at": "2023-11-07T05:31:56Z",
"credentials_rotation_requested_at": "2023-11-07T05:31:56Z",
"resync_requested_at": "2023-11-07T05:31:56Z",
"revoked_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}Connect offline POS devices
Revoke a POS sync device
Permanently cuts off a POS device from syncing, for example when it is lost or retired.
POST
/
catalog
/
pos-sync
/
instances
/
{instance}
/
revoke
Revoke a POS sync device
curl --request POST \
--url https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.exowpee.com/v1/catalog/pos-sync/instances/{instance}/revoke")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "<string>",
"computer_id": "<string>",
"name": "<string>",
"platform": "<string>",
"status": "<string>",
"last_seen_at": "2023-11-07T05:31:56Z",
"last_reported_state": "<string>",
"last_reported_meta": {},
"credentials_rotated_at": "2023-11-07T05:31:56Z",
"credentials_rotation_requested_at": "2023-11-07T05:31:56Z",
"resync_requested_at": "2023-11-07T05:31:56Z",
"revoked_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}Company space
Cannot be undone
For: Manager, Integrator · Permission:
pos_sync_instances.revoke
Conditions
- A revoked device cannot be revoked again, and there is no way to restore it; the computer must register again.
- If the sync broker refuses to remove the device’s access, nothing is changed and the device stays active.
- Deletes the device’s broker credential immediately, so any running sync session stops.
- Sets the device to revoked with the time and the actor, clears any pending rotation request and removes the stored credentials replay bundle.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the POS sync device (27-character KSUID).
Response
200 - application/json
PosSyncInstanceResource
Items of this page.
Show child attributes
Show child attributes