GET Read a workspace icon
/api/v1/workspaces/{id}/icon/{version}
Read the current version of an uploaded icon. Requires workspace read access. The image is private and is not stored in shared caches. A removed or replaced version is no longer available.
On this page
Access and permissions
Read the current version of an uploaded icon. Requires workspace read access. The image is private and is not stored in shared caches. A removed or replaced version is no longer available.
Browser session: __Host-mb_session cookie.
Machine management credentials in Authorization: Bearer. Check the permissions (scopes) required by the operation.
Parameters and headers
| Field | Location | Type and limits | Required | Meaning |
|---|---|---|---|---|
| id | Path | string; {"format":"uuid"} | Yes | Resource UUID from the path. It must exist and be accessible to the acting identity. |
| version | Path | string; {"format":"uuid"} | Yes | Current image version from icon_url. |
Request body
No request body.
Responses
image/png
| Field | Type and limits | Required | Meaning |
|---|---|---|---|
| $ | string | Yes | — |
| Stable error codes |
|---|
| status_page_operation |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
| Stable error codes |
|---|
| status_page_operation |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
| Stable error codes |
|---|
| status_page_operation |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
| Stable error codes |
|---|
| status_page_operation |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
| Stable error codes |
|---|
| status_page_operation |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
| Stable error codes |
|---|
| status_page_operation |
| status_pages_disabled |
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 | — |
| $.limit | integer | string | No | Resource protection returns HTTP 429 with Retry-After, a limit identifier and scope. Retry only after the waiting time; telemetry retries must preserve IDs and payloads. Rejected telemetry batches are atomic. |
| $.scope | string; {"enum":["owner","actor","free_pool","platform","capacity","network"]} | No | — |
| $.field_errors | array<object>; {"maxItems":64} | No | — |
| $.field_errors[] | object | Yes | — |
| $.field_errors[].path | string; {"maxLength":256} | Yes | — |
| $.field_errors[].message_key | string | Yes | — |
| $.field_errors[].message_params | object; {"additionalProperties":true} | No | — |
Retries and asynchronous work
This operation reads or validates without applying a resource mutation. Respect rate limits and credential lifetime.
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 --request GET --cookie '__Host-mb_session=SESSION; __Host-mb_csrf=CSRF' --header 'X-CSRF-Token: CSRF' 'https://metribeacon.com/api/v1/status-pages/11111111-1111-4111-8111-111111111111/assets/11111111-1111-4111-8111-111111111111'import requests
response = requests.request("GET","https://metribeacon.com/api/v1/status-pages/11111111-1111-4111-8111-111111111111/assets/11111111-1111-4111-8111-111111111111",cookies={"__Host-mb_session":"SESSION","__Host-mb_csrf":"CSRF"},headers={"X-CSRF-Token":"CSRF"})
response.raise_for_status()const response = await fetch("https://metribeacon.com/api/v1/status-pages/11111111-1111-4111-8111-111111111111/assets/11111111-1111-4111-8111-111111111111", {signal:AbortSignal.timeout(10000),method:"GET",credentials:"same-origin",headers:{"Content-Type":"application/json","X-CSRF-Token":csrf}});
if (!response.ok) throw new Error(String(response.status));package main
import (
"fmt"
"net/http"
"time"
)
func main() {
if err := requestStatus(); err != nil { panic("request failed; credentials and response omitted") }
}
func requestStatus() error {
req, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/status-pages/11111111-1111-4111-8111-111111111111/assets/11111111-1111-4111-8111-111111111111", nil)
if err != nil { return err }
req.AddCookie(&http.Cookie{Name:"__Host-mb_session",Value:"SESSION"})
req.AddCookie(&http.Cookie{Name:"__Host-mb_csrf",Value:"CSRF"})
req.Header.Set("X-CSRF-Token","CSRF")
client := &http.Client{Timeout: 10*time.Second}
response, err := client.Do(req)
if err != nil { return err }
defer response.Body.Close()
fmt.Println(response.StatusCode)
return nil
}