investigate_url
Idempotent
Investigate a supplied public URL and create a tenant-owned case. First create_quote(action='investigate', input={rights_holder_id, work_id, delegation_id, url}). Results include case_id, evidence_id, page metadata, registrar/network attribution, supported contacts and retrieval limitations. CDN visibility does not prove the origin host. Investigation does not send a notice. Authenticate with the matching action scope. Reserves the quoted maximum from prepaid credits and returns operation_id; poll get_operation for results. Sandbox execution is simulated.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quote_id | Yes | Unexpired quote ID returned by create_quote for action="investigate" in this organization; all task input is stored in the quote. | |
| idempotency_key | Yes | Caller-generated key, 8–128 letters, digits, underscores, dots, colons or hyphens. Reuse for retries of the same purchase or operation. Different input with the same organization-bound key returns a conflict. |