Capabilities

create_download_grant

Authorize a five-minute binary download of the exact current manifest. The original bearer is required at delivery.

How this capability is exposed

Stable ID: ursy.cloud:create_download_grant
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:create_download_grant",
    "name": "create_download_grant",
    "description": "Authorize a five-minute binary download of the exact current manifest. The original bearer is required at delivery.",
    "method": "POST",
    "path": "/v1/files/{file_id}/download-grants",
    "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
            "file_id": {
                "type": "string",
                "pattern": "^file_[1-9][0-9]{0,14}$"
            },
            "if_match": {
                "type": "string",
                "pattern": "^\"[0-9a-f]{64}\"$"
            },
            "idempotency_key": {
                "type": "string",
                "minLength": 8,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9._:-]+$"
            }
        },
        "required": [
            "file_id",
            "if_match",
            "idempotency_key"
        ]
    },
    "outputSchema": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
            "download": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "id": {
                        "type": "string",
                        "pattern": "^dl_[a-f0-9]{32}$"
                    },
                    "file_id": {
                        "type": "string",
                        "pattern": "^file_[1-9][0-9]{0,14}$"
                    },
                    "version_id": {
                        "type": "string",
                        "pattern": "^ver_[1-9][0-9]*$"
                    },
                    "url": {
                        "type": "string"
                    },
                    "expires_at": {
                        "type": "string"
                    },
                    "size": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 26214400
                    },
                    "sha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                    },
                    "authorization": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "file_id",
                    "version_id",
                    "url",
                    "expires_at",
                    "size",
                    "sha256",
                    "authorization"
                ]
            },
            "request_id": {
                "type": "string"
            },
            "replayed": {
                "type": "boolean"
            }
        },
        "required": [
            "download"
        ]
    },
    "auth_required": true,
    "scope": "cloud.files.binary.read",
    "read_only": false,
    "service_id": "ursy-cloud",
    "parent_id": "",
    "summary": "Authorize a five-minute binary download of the exact current manifest. The original bearer is required at delivery.",
    "source_url": "https://api.ursy.cloud/v1/registry-capabilities",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-14 04:03:00",
    "revision": "75803bf1abdf2c1d8e1fdcfb141f48a99853991601fe780c2843f1db2c255d95",
    "type": "capabilities",
    "source": {
        "url": "https://api.ursy.cloud/v1/registry-capabilities",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-14 04:03:00",
    "stale": false
}