Get registry metrics

GET

/container-registry/registries/:registry_id/metrics

GET

/v1/container-registry/registries/:registry_id/metrics

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# REGISTRY_ID: Registry ID
curl "https://api.ibee.ai/v1/container-registry/registries/$REGISTRY_ID/metrics?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

{
  "registry_id": "4f2a9c1e-7b3d-4e8a-9f10-2c5d6e7f8a9b",
  "range": "24h",
  "granularity": "15m",
  "range_start": "2026-10-25T12:00:00Z",
  "range_end": "2026-10-25T12:00:00Z",
  "generated_at": "2026-10-25T12:00:00Z",
  "storage": {
    "used_bytes": 1,
    "quota_bytes": 1,
    "remaining_bytes": 1,
    "utilization_percent": 1,
    "measured_at": "2026-10-25T12:00:00Z",
    "gb_definition_bytes": 1,
    "used_gb": 1,
    "quota_gb": 1,
    "remaining_gb": 1
  },
  "bandwidth": {
    "used_bytes": 1
  },
  "bandwidth_points": [
    {
      "timestamp": "2026-10-25T12:00:00Z",
      "used_bytes": 1
    }
  ],
  "coverage": {
    "status": "provisional",
    "data_available_from": "2026-10-25T12:00:00Z",
    "data_through": "2026-10-25T12:00:00Z"
  }
}

Returns storage use against the plan quota and outbound bandwidth over the last 24 hours, 7 days or 30 days. Bytes are decimal (1 GB = 1,000,000,000 bytes). Requires scope: container-registry.read.

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# REGISTRY_ID: Registry ID
curl "https://api.ibee.ai/v1/container-registry/registries/$REGISTRY_ID/metrics?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $IBEE_API_TOKEN"

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

registry_idstringRequiredformat: "uuid"

Registry ID.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

rangeenumOptionalDefaults to 24h

Time window.

Allowed values:

Response

Metrics returned.

registry_idstringformat: "uuid"

ID of the registry.

rangeenum

Window covered.

24h
7d
30d

Allowed values:

granularityenum

Spacing of bandwidth_points.

15m
1h
1d

Allowed values:

range_startdatetime

Start of the window (ISO 8601).

range_enddatetime

End of the window (ISO 8601).

generated_atdatetime

When the metrics were computed (ISO 8601).

storageobject

Storage use against the plan quota.

bandwidthobject

Outbound bandwidth over the window.

bandwidth_pointslist of objects

Outbound bytes per interval across the window.

coverageobject

How complete the bandwidth data is for the window.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

503

Service Unavailable Error