Poll CLI Authorization
curl --request POST \
--url https://api.example.com/api/v1/auth/cli/poll \
--header 'Content-Type: application/json' \
--data '
{
"poll_secret": "<string>"
}
'import requests
url = "https://api.example.com/api/v1/auth/cli/poll"
payload = { "poll_secret": "<string>" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({poll_secret: '<string>'})
};
fetch('https://api.example.com/api/v1/auth/cli/poll', 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.example.com/api/v1/auth/cli/poll",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'poll_secret' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/auth/cli/poll"
payload := strings.NewReader("{\n \"poll_secret\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
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.example.com/api/v1/auth/cli/poll")
.header("Content-Type", "application/json")
.body("{\n \"poll_secret\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/auth/cli/poll")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"poll_secret\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"status": "pending",
"interval_seconds": 123,
"scope": "instance",
"token": "<string>",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_name": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authentication
Poll CLI Authorization
Return pending status or deliver the approved scoped management key once.
When the request includes the CLI’s current management key for the same user and scope, that key is revoked as part of replacement. Labels do not participate in matching.
Authentication: none.
POST
/
api
/
v1
/
auth
/
cli
/
poll
Poll CLI Authorization
curl --request POST \
--url https://api.example.com/api/v1/auth/cli/poll \
--header 'Content-Type: application/json' \
--data '
{
"poll_secret": "<string>"
}
'import requests
url = "https://api.example.com/api/v1/auth/cli/poll"
payload = { "poll_secret": "<string>" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({poll_secret: '<string>'})
};
fetch('https://api.example.com/api/v1/auth/cli/poll', 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.example.com/api/v1/auth/cli/poll",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'poll_secret' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/auth/cli/poll"
payload := strings.NewReader("{\n \"poll_secret\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
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.example.com/api/v1/auth/cli/poll")
.header("Content-Type", "application/json")
.body("{\n \"poll_secret\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/auth/cli/poll")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"poll_secret\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"status": "pending",
"interval_seconds": 123,
"scope": "instance",
"token": "<string>",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_name": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}