[{"data":1,"prerenderedAt":112},["ShallowReactive",2],{"doc-list-oracles":3},{"blocks":4,"markdown":111},[5,98,101,105,107],{"kind":6,"method":7,"path":8,"operation":9,"example":18,"response":51,"errors":79,"authErrors":80},"endpoint","GET","\u002Fv1\u002Foracles",{"method":7,"path":8,"summary":10,"description":11,"parameters":12,"body":13,"responses":14},"List Oracles","What this caller can ask, in the vocabulary they ask it in.\n\nFree — listing the catalogue costs no credits. The catalogue is the\ncontract: an oracle absent from it is not available to this caller, and a\nformat absent from an entry's `formats` is refused by `ask`. Read it at\nstart-up rather than hardcoding names, and a new oracle becomes available\nwithout a change on the caller's side.\n\n`drawable_formats` are the formats `POST \u002Fv1\u002Ffigures\u002Frender` can draw; an\nanswer in any other format is source only. Choose one of them when the\nresult has to be looked at. It is empty for an oracle whose answers are not\ndrawings.",[],[],[15],{"status":16,"description":17},"200","Every oracle this key may call.",{"status":19,"response":20},200,{"oracles":21},[22,33,42],{"name":23,"description":24,"formats":25,"default_format":30,"drawable_formats":31,"views":32},"chart","Describe a chart in plain language and get back a chart specification that has been checked against versioned rules before you see it.",[26,27,28,29,30],"chartjs","echarts","gnuplot","plotly","vega-lite",[28,30],{},{"name":34,"description":35,"formats":36,"default_format":39,"drawable_formats":40,"views":41},"vector-graphics","Describe a drawing in plain language and get back vector source that has been checked against versioned rules before you see it.",[37,38,39],"metapost","pictex","tikz",[37,38,39],{},{"name":43,"description":44,"formats":45,"default_format":46,"drawable_formats":47,"views":48},"coverage-policy","Ask a question about the Medicare knee replacement policy (LCD L36575) and get back the rules, conditions and statements that answer it as JSON, each with the policy passage it comes from, checked against versioned rules before you see it.",[46],"lookup",[],{"lookup":49},[50],"summary",{"status":16,"description":17,"binary":52,"fields":53},false,[54,58,62,65,69,72,75],{"name":55,"type":56,"description":57},"oracles","object[]","Every oracle this key may call",{"name":59,"type":60,"description":61},"oracles[].name","string","What you put in the ask URL",{"name":63,"type":60,"description":64},"oracles[].description","One line, safe to show a user",{"name":66,"type":67,"description":68},"oracles[].formats","string[]","Every value `format` accepts, sorted",{"name":70,"type":60,"description":71},"oracles[].default_format","Used when you send no `format`",{"name":73,"type":67,"description":74},"oracles[].drawable_formats","The formats `POST \u002Fv1\u002Ffigures\u002Frender` can draw. An answer in any other format is source only",{"name":76,"type":77,"description":78},"oracles[].views","object","Format to the views you can ask for beside its answer, such as `{\"lookup\": [\"summary\"]}`. Empty for an oracle with none",[],[81,85,88,91,94],{"status":82,"code":83,"when":84},401,"KEY_MISSING","No `Authorization` header",{"status":82,"code":86,"when":87},"KEY_UNKNOWN","The key is not one we issued",{"status":82,"code":89,"when":90},"KEY_REVOKED","The key was revoked in the console",{"status":82,"code":92,"when":93},"KEY_EXPIRED","The key is past its expiry",{"status":95,"code":96,"when":97},403,"ORG_DISABLED","The key is fine; its organisation is not active",{"kind":99,"html":100},"html","\u003Ch2 id=\"response\">Response\u003C\u002Fh2>\n",{"kind":102,"lang":103,"code":104},"code","json","{\n  \"oracles\": [\n    {\n      \"name\": \"chart\",\n      \"description\": \"Describe a chart in plain language and get back a chart specification that has been checked against versioned rules before you see it.\",\n      \"formats\": [\"chartjs\", \"echarts\", \"gnuplot\", \"plotly\", \"vega-lite\"],\n      \"default_format\": \"vega-lite\",\n      \"drawable_formats\": [\"gnuplot\", \"vega-lite\"],\n      \"views\": {}\n    },\n    {\n      \"name\": \"vector-graphics\",\n      \"description\": \"Describe a drawing in plain language and get back vector source that has been checked against versioned rules before you see it.\",\n      \"formats\": [\"metapost\", \"pictex\", \"tikz\"],\n      \"default_format\": \"tikz\",\n      \"drawable_formats\": [\"metapost\", \"pictex\", \"tikz\"],\n      \"views\": {}\n    },\n    {\n      \"name\": \"coverage-policy\",\n      \"description\": \"Ask a question about the Medicare knee replacement policy (LCD L36575) and get back the rules, conditions and statements that answer it as JSON, each with the policy passage it comes from, checked against versioned rules before you see it.\",\n      \"formats\": [\"lookup\"],\n      \"default_format\": \"lookup\",\n      \"drawable_formats\": [],\n      \"views\": { \"lookup\": [\"summary\"] }\n    }\n  ]\n}",{"kind":99,"html":106},"\u003Ch2 id=\"notes\">Notes\u003C\u002Fh2>\n\u003Cp>Listing costs no credits.\u003C\u002Fp>\n\u003Cp>\u003Ccode>drawable_formats\u003C\u002Fcode> are the formats \u003Ca href=\"\u002Ffigures\">Draw a figure\u003C\u002Fa> can draw. An answer\nin any other format comes back as source only, so pick one of these when the\nresult has to be looked at. It is empty for \u003Ccode>coverage-policy\u003C\u002Fcode>, whose answers are JSON documents.\u003C\u002Fp>\n\u003Cp>\u003Ccode>views\u003C\u002Fcode> names, per format, what you can ask for beside an answer by sending\n\u003Ccode>views\u003C\u002Fcode> with the ask: today a \u003Ccode>summary\u003C\u002Fcode> of a \u003Ccode>coverage-policy\u003C\u002Fcode> lookup. It is\nempty for an oracle with none.\u003C\u002Fp>\n\u003Cp>The response describes what you can ask for and what it costs — nothing about\nhow an answer is produced. That part is ours, and it changes.\u003C\u002Fp>\n\u003Cp>The catalogue is the contract. An oracle absent from this list is not available\nto your key and asking it answers \u003Ccode>404\u003C\u002Fcode>; a format absent from \u003Ccode>formats\u003C\u002Fcode> is\nrefused with \u003Ccode>422\u003C\u002Fcode> and the response names the ones that would work.\u003C\u002Fp>\n\u003Cp>Read this at start-up rather than hardcoding names, and a new oracle becomes\navailable to your integration without a deploy.\u003C\u002Fp>\n\u003Ch2 id=\"what-you-actually-have\">What you actually have\u003C\u002Fh2>\n\u003Cp>The console shows the same list for your organisation, with a playground for\neach oracle.\u003C\u002Fp>\n",{"kind":108,"path":109,"label":110},"console","\u002Foracles","Browse the oracles","# List oracles\n\n> Every oracle this key may call. Free.\n\n`GET https:\u002F\u002Fapi.formalogic.io\u002Fv1\u002Foracles`\n\nResponse 200: Every oracle this key may call.\n\n| Field | Type | Present | Meaning |\n|---|---|---|---|\n| `oracles` | object[] | always | Every oracle this key may call |\n| `oracles[].name` | string | always | What you put in the ask URL |\n| `oracles[].description` | string | always | One line, safe to show a user |\n| `oracles[].formats` | string[] | always | Every value `format` accepts, sorted |\n| `oracles[].default_format` | string | always | Used when you send no `format` |\n| `oracles[].drawable_formats` | string[] | always | The formats `POST \u002Fv1\u002Ffigures\u002Frender` can draw. An answer in any other format is source only |\n| `oracles[].views` | object | always | Format to the views you can ask for beside its answer, such as `{\"lookup\": [\"summary\"]}`. Empty for an oracle with none |\n\nErrors (plus 401 `KEY_MISSING`, `KEY_UNKNOWN`, `KEY_REVOKED`, `KEY_EXPIRED` and 403 `ORG_DISABLED` on every endpoint):\n\n## Response\n\n```json\n{\n  \"oracles\": [\n    {\n      \"name\": \"chart\",\n      \"description\": \"Describe a chart in plain language and get back a chart specification that has been checked against versioned rules before you see it.\",\n      \"formats\": [\"chartjs\", \"echarts\", \"gnuplot\", \"plotly\", \"vega-lite\"],\n      \"default_format\": \"vega-lite\",\n      \"drawable_formats\": [\"gnuplot\", \"vega-lite\"],\n      \"views\": {}\n    },\n    {\n      \"name\": \"vector-graphics\",\n      \"description\": \"Describe a drawing in plain language and get back vector source that has been checked against versioned rules before you see it.\",\n      \"formats\": [\"metapost\", \"pictex\", \"tikz\"],\n      \"default_format\": \"tikz\",\n      \"drawable_formats\": [\"metapost\", \"pictex\", \"tikz\"],\n      \"views\": {}\n    },\n    {\n      \"name\": \"coverage-policy\",\n      \"description\": \"Ask a question about the Medicare knee replacement policy (LCD L36575) and get back the rules, conditions and statements that answer it as JSON, each with the policy passage it comes from, checked against versioned rules before you see it.\",\n      \"formats\": [\"lookup\"],\n      \"default_format\": \"lookup\",\n      \"drawable_formats\": [],\n      \"views\": { \"lookup\": [\"summary\"] }\n    }\n  ]\n}\n```\n\n## Notes\n\nListing costs no credits.\n\n`drawable_formats` are the formats [Draw a figure](https:\u002F\u002Fdocs.formalogic.io\u002Ffigures) can draw. An answer\nin any other format comes back as source only, so pick one of these when the\nresult has to be looked at. It is empty for `coverage-policy`, whose answers are JSON documents.\n\n`views` names, per format, what you can ask for beside an answer by sending\n`views` with the ask: today a `summary` of a `coverage-policy` lookup. It is\nempty for an oracle with none.\n\nThe response describes what you can ask for and what it costs — nothing about\nhow an answer is produced. That part is ours, and it changes.\n\nThe catalogue is the contract. An oracle absent from this list is not available\nto your key and asking it answers `404`; a format absent from `formats` is\nrefused with `422` and the response names the ones that would work.\n\nRead this at start-up rather than hardcoding names, and a new oracle becomes\navailable to your integration without a deploy.\n\n## What you actually have\n\nThe console shows the same list for your organisation, with a playground for\neach oracle.\n\n[Browse the oracles](https:\u002F\u002Fapp.formalogic.io\u002Foracles)\n",1793819973843]