GET Poll the linked device request
/api/v1/agent/device-links/{id}
Poll the linked device request
On this page
Access and permissions
Poll the linked device request
deviceLinkClient
Parameters and headers
| Field | Location | Type and limits | Required | Meaning |
|---|---|---|---|---|
| id | Path | string; {"format":"uuid"} | Yes | Generate secrets locally and submit only hashes. Repeating an identical request with the same client token returns the same challenge. No account is created. |
Request body
No request body.
Responses
application/json
| Field | Type and limits | Required | Meaning |
|---|---|---|---|
| $ | DeviceLinkStatus | Yes | — |
| $.account_id | string; {"format":"uuid"} | No | — |
| $.credential_id | string; {"format":"uuid"} | No | — |
| $.device_id | string; {"format":"uuid"} | No | — |
| $.heartbeat_accepted | boolean | No | — |
| $.key_id | string; {"format":"uuid"} | No | — |
| $.measurement_accepted | boolean | No | — |
| $.status | string; {"enum":["pending","approved","expired","cancelled"]} | Yes | — |
| $.workspace_id | string; {"format":"uuid"} | No | — |
| Stable error codes |
|---|
| invalid_link |
| Stable error codes |
|---|
| invalid_link |
| Stable error codes |
|---|
| unavailable |
application/problem+json
| Field | Type and limits | Required | Meaning |
|---|---|---|---|
| $ | Problem | Yes | — |
| $.code | string | Yes | Stable machine-readable error code |
| $.detail | string | Yes | Short localized explanation without internal error details |
| $.instance | string | Yes | Unique relative identifier /api/v1/requests/{request_id}; not a retrievable resource |
| $.message | string | Yes | Temporarily identical to detail for existing clients |
| $.message_key | string | Yes | Stable translation key for changing the displayed language without another request |
| $.message_params | object; {"additionalProperties":true} | Yes | Named, safely rendered message parameters; never arbitrary HTML |
| $.request_id | string; {"pattern":"^[0-9a-f]{32}$"} | Yes | Server-generated diagnostic identifier. It contains no login token or credential. |
| $.status | integer; {"maximum":599,"minimum":400} | Yes | — |
| $.title | string | Yes | Localized HTTP status title |
| $.type | string; {"const":"about:blank"} | Yes | — |
Retries and asynchronous work
This change does not have a general retry guarantee. If the response is unclear, read the affected resource before trying again. Follow Retry-After waiting times and request new sign-in or action codes when they expire.
Request examples
Replace demo IDs, timestamps and placeholders with your own values. For a retry, keep the same IDs, time and content. These examples do not run requests on this page.
Keep login links, codes, cookies and keys private. Do not print them in logs or share them in support requests.
curl --fail-with-body --request GET https://metribeacon.com/api/v1/agent/device-links/00000000-0000-4000-8000-000000000001 --header 'Accept: application/json' --header 'Authorization: Bearer mbl_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'import urllib.request
headers = {'Accept': 'application/json', 'Authorization': 'Bearer mbl_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}
request = urllib.request.Request('https://metribeacon.com/api/v1/agent/device-links/00000000-0000-4000-8000-000000000001', headers=headers, method='GET')
with urllib.request.urlopen(request) as response:
print(response.read().decode())
const response = await fetch("https://metribeacon.com/api/v1/agent/device-links/00000000-0000-4000-8000-000000000001", {"method": "GET", "headers": {"Accept": "application/json", "Authorization": "Bearer mbl_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
package main
import ("fmt"; "io"; "net/http"; "strings")
func main() {
req, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/agent/device-links/00000000-0000-4000-8000-000000000001", strings.NewReader("")); if err != nil { panic(err) }
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer mbl_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
response, err := http.DefaultClient.Do(req); if err != nil { panic(err) }; defer response.Body.Close(); data, err := io.ReadAll(response.Body); if err != nil { panic(err) }; fmt.Printf("HTTP %d\n%s\n", response.StatusCode, data)
}
Related guides
- HTTP API, OAuth and MCP
Find the user API endpoints, their permissions, fields, examples and response formats.
- DELETE Cancel a device link and revoke credentials already issued by it
Cancel a device link and revoke credentials already issued by it
- POST Start a ten-minute device link
Generate secrets locally and submit only hashes. Repeating an identical request with the same client token returns the same challenge. No account is created.
- GET Confirm that heartbeat and an enabled measurement were accepted
Confirm the selected agent profile through saved data: a heartbeat and a numeric or state value from an enabled profile series, received since the requested time. Installer and process status do not establish readiness.