{"service":"DataStore API","tools":[{"name":"store","description":"Store JSON or a file for later retrieval. Costs $0.01 USDC via x402. Returns an id and a one-time secret.","endpoint":{"method":"POST","url":"https://fileshareforagents.online/v1/items"},"input_schema":{"type":"object","properties":{"content":{"type":"string","description":"The raw content to store (JSON text or file bytes)."},"content_type":{"type":"string","description":"Optional MIME type. Detected from content when omitted."},"ttl_days":{"type":"integer","minimum":1,"maximum":365,"default":7},"label":{"type":"string","maxLength":100,"description":"Optional label to recognise the item later."}},"required":["content"]}},{"name":"retrieve","description":"Retrieve the full content of a stored item. Counts one read.","endpoint":{"method":"GET","url":"https://fileshareforagents.online/v1/items/{id}","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}},{"name":"status","description":"Get expiry, remaining reads, size and type of an item. Free.","endpoint":{"method":"GET","url":"https://fileshareforagents.online/v1/items/{id}/status","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}},{"name":"extend","description":"Set a new expiry, up to 365 days from now. Costs $0.01.","endpoint":{"method":"POST","url":"https://fileshareforagents.online/v1/items/{id}/extend","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"},"ttl_days":{"type":"integer","minimum":1,"maximum":365}},"required":["id","secret","ttl_days"]}},{"name":"share_link","description":"Create a signed, time-limited URL that lets anyone read the item without the secret. The URL is the credential and bypasses any password; each open counts one read. Free.","endpoint":{"method":"POST","url":"https://fileshareforagents.online/v1/items/{id}/links","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds"}},"required":["id","secret","expires_in"]}},{"name":"revoke_links","description":"Invalidate every share link issued so far for the item. Free.","endpoint":{"method":"POST","url":"https://fileshareforagents.online/v1/items/{id}/links/revoke","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}},{"name":"set_password","description":"Protect the item's public address (links.public) with a password of 12 to 128 characters. Anyone with the address and the password can read it (browsers get a form, agents send an x-password header). Free.","endpoint":{"method":"PUT","url":"https://fileshareforagents.online/v1/items/{id}/password","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"},"password":{"type":"string","minLength":12,"maxLength":128}},"required":["id","secret","password"]}},{"name":"remove_password","description":"Remove the password; the public address then answers 404 (signed links still work). Free.","endpoint":{"method":"DELETE","url":"https://fileshareforagents.online/v1/items/{id}/password","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}},{"name":"delete","description":"Delete an item now. No refund.","endpoint":{"method":"DELETE","url":"https://fileshareforagents.online/v1/items/{id}","auth":"Bearer {secret}"},"input_schema":{"type":"object","properties":{"id":{"type":"string"},"secret":{"type":"string"}},"required":["id","secret"]}},{"name":"feedback","description":"Tell the service what is missing or broken. Free.","endpoint":{"method":"POST","url":"https://fileshareforagents.online/v1/feedback"},"input_schema":{"type":"object","properties":{"type":{"type":"string","enum":["missing","bug","abuse","other"]},"message":{"type":"string","maxLength":2000},"item_id":{"type":"string"},"request_id":{"type":"string"}},"required":["type","message"]}}]}