Capabilities

list_versions

List immutable version metadata with bounded cursor pagination.

How this capability is exposed

Stable ID: ursy.cloud:list_versions
Owning service: URSY.cloud
Runtime: See the source declaration

Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.

Accepted contract

REGISTRY JSON

{
    "id": "ursy.cloud:list_versions",
    "name": "list_versions",
    "description": "List immutable version metadata with bounded cursor pagination.",
    "method": "GET",
    "path": "/v1/files/{file_id}/versions",
    "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
            "file_id": {
                "type": "string",
                "pattern": "^file_[1-9][0-9]{0,14}$"
            },
            "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
            },
            "cursor": {
                "type": "string",
                "maxLength": 2048,
                "x-ursy-maxBytes": 2048
            }
        },
        "required": [
            "file_id"
        ]
    },
    "outputSchema": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
            "versions": {
                "type": "array",
                "items": {
                    "type": "object",
                    "additionalProperties": true
                },
                "minItems": 0,
                "maxItems": 100
            },
            "next_cursor": {
                "oneOf": [
                    {
                        "type": "string"
                    },
                    {
                        "type": "null"
                    }
                ]
            },
            "has_more": {
                "type": "boolean"
            },
            "request_id": {
                "type": "string"
            },
            "replayed": {
                "type": "boolean"
            }
        },
        "required": [
            "versions",
            "next_cursor",
            "has_more"
        ]
    },
    "auth_required": true,
    "scope": "cloud.versions.read",
    "read_only": true,
    "service_id": "ursy-cloud",
    "parent_id": "",
    "summary": "List immutable version metadata with bounded cursor pagination.",
    "source_url": "https://api.ursy.cloud/v1/registry-capabilities",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-15 07:32:11",
    "revision": "0c56c49bf6121037a2ae726a69570861b82f834f3dea6fa0269425cefbfbc59b",
    "type": "capabilities",
    "source": {
        "url": "https://api.ursy.cloud/v1/registry-capabilities",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-15 07:32:11",
    "stale": false
}