build_request_url
Build a prefilled WhatDoTheyKnow request URL.
get_request_feed_items
Return parsed Atom feed entries for a specific FOI request as structured objects.
Use this instead of reading the raw wdtk://requests/{slug}/feed resource when you
want structured AtomEntry objects rather than raw XML. Each entry's `link` field
contains the request URL; use the slug from that URL with request_json or
authority_json for full detail.
search_request_events
Search WhatDoTheyKnow's feed-based event index and return structured results.
Call this to find FOI requests matching a query expression. Returns up to `limit`
AtomEntry objects. Use the `link` field of each result as the next navigation
step — extract the request slug and call the wdtk://requests/{slug} resource or
get_request_feed_items for full detail.
Example expressions:
status:successful
body:"Liverpool City Council"
(variety:sent OR variety:response) status:successful
search_authorities
Search WhatDoTheyKnow public authorities by name.
Returns up to `limit` authorities whose name or short_name contains `query`
(case-insensitive). Use the `slug` field with authority_json or
build_request_url as the next step.
Example: search_authorities("Liverpool") → slug "liverpool_city_council"
Then: authority_json with that slug, or build_request_url with it.
create_request_record
Create a request through the experimental write API.
Requires WDTK_API_KEY in the server environment.
update_request_state
Update the user-assessed state of a request through the experimental write API.
Requires WDTK_API_KEY in the server environment.