Market Radar API
API referenceFolders

Create a folder

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.

POST
/folders

Authorization

key
AuthorizationBearer <token>

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/folders" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "id": 1,  "name": "string",  "radar_ids": [    1  ],  "created_at": "2019-08-24T14:15:22Z"}

The folders GET

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.

Rename a folder PATCH

A new name, as Rename in the app does. Its radars stay in it, and name it anew. Another folder's name, whatever its case, fails with conflict; the folder's own name in another case is saved.