Measure a dataset URL (free, books nothing)
describeDatasetMeasure a public https dataset URL and return its exact sizeBytes, sha256 and contentType, plus suggestedEntry — a filled-in element of the spec's datasets[] array you can paste straight in. Call it before submitJob whenever you want datasets[] to stage and verify a file: sizeBytes and sha256 are REQUIRED on every entry, and this is how you get them without pulling the data down to your own machine first. We read the URL from our side, stream it through a hash and keep no copy. Free, books nothing, and it never reads the caller's filesystem. https only, and only addresses on the public internet: a loopback, private, link-local or otherwise reserved host is refused, and so is a redirect that leads to one. There is an upper size limit and a limit on how often one session may call it; both refusals say so plainly. You do NOT need this when your command downloads its own data with curl or wget — datasets[] is the verified-staging path, and only that path needs a hash declared up front.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https URL of the dataset file. Symbioza fetches it from its own side — your own machine is never on the data path, and a URL that needs a credential to read should be a signed URL with the shortest expiry that covers staging — once submitted it is stored with the job spec in clear and included in our backups. | |
| authKey | No | Usually omit this. The customer door — the OAuth-signed-in HTTPS connector at https://symbioza.dev/mcp — authenticates the session itself, so no key is passed per call. Only a self-hosted or test transport passes a key here. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Machine-readable refusal code: unauthorized, invalid_spec, budget_too_low, insufficient_balance, access_required, secret_conflict, no_compute, unavailable, refused | |
| action | No | The one next step: authenticate, fix_spec, raise_budget, add_funds, claim_credit, add_access, relax_spec_or_retry, retry_later, contact_support | |
| reason | No | Why, in a customer-safe sentence | |
| sha256 | No | ||
| rejected | No | Present and true when the call was refused; nothing was booked or charged | |
| sizeBytes | No | ||
| contentType | No | ||
| suggestedEntry | No | A datasets[] element for the spec, ready to paste | |
| supportedImages | No | On an unverified-image refusal: the images the door accepts |