The folders
Every radar lives in exactly one folder, one level deep. By name, each with its radars' ids. Not paged: an account holds at most 20. A radar names its folder too; move it with PATCH /radars/{id} and folder_id.
A key created in the app under Settings, API and MCP. Read keys read; Read and write keys also add, edit and delete companies, custom sources, groups and radars, and create, rename and delete folders.
In: header
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/folders"{ "data": [ { "id": 1, "name": "string", "radar_ids": [ 1 ], "created_at": "2019-08-24T14:15:22Z" } ]}Delete a custom source DELETE
Every radar that searched it stops (its radar_ids say which); a radar for which it was the last source searches the open web again. The signals already found on it stay. No sweep starts.
Create a folder POST
An empty folder, as Create folder in the app does. Put a radar in it with POST /radars and its id as folder_id, or move one in with PATCH /radars/{id}. A name the account already has, whatever its case, fails with conflict. No plan limits folders.