DECADocs
decalabs.aiDashboard

Tools

get_my_ideas

The ideas DECA's engine wrote for your own workspace, each with why it is yours.

GET/api/agent/my-ideas
MCP tool get_my_ideasNeeds a keyFree

get_ideas returns what DECA's radar found for everyone. get_my_ideas returns what it found for you: ideas the engine wrote for your workspace from what it knows about you, and the day's public ideas it picked as the best fit for you, each with the reason.

The engine learns about you in the dashboard, under Settings → Your radar: your company's site and what you sell, or, for one person, what you can do, spend and care about. New ideas for you arrive every day.

Private by design

  • It needs an API key. The key says whose ideas to return. Without one the call is refused with key_required.
  • A key sees only its own workspace. No call can read another workspace's ideas, profile or picks.
  • Read only. The tool returns what the engine has already written. It never asks the engine to write more; that stays your choice in the dashboard.
  • Ideas written for you are never published. They do not appear in get_ideas or on the public board.

Parameters

Name Type Description
include all · written · picks Ideas written for you, the day's picks for you, or both. Default both.
limit integer How many of each to return, 1 to 25. Default 10.

Request

curl -H "Authorization: Bearer deca_sk_…" \
  "https://app.decalabs.ai/api/agent/my-ideas?limit=5"

Response

JSON
{
  "day": "2026-11-18",
  "profile": {
    "state": "ready",
    "kind": "company",
    "summary": "A booking platform for hair salons in Germany, with 4,000 salons as customers…"
  },
  "written": [
    {
      "id": "…",
      "name": "…",
      "one_line": "…",
      "why_you": "Your salons already hold their clients' booking history, so…",
      "verdict": "go",
      "evidence": { "apps": ["…"], "posts": ["…"] },
      "expected": { "signup_rate": 0.034, "…": "…" },
      "url": "https://app.decalabs.ai/board/…"
    }
  ],
  "picks": [
    { "id": "…", "name": "…", "why": "It sells to the same small businesses you already reach…", "…": "…" }
  ]
}

Each idea has the same fields as in get_ideas, plus:

Field Description
written[].why_you Why the engine wrote this idea for you.
picks[].why Why this public idea fits you.
profile.state none (not set up yet), reading (being made, ideas follow in minutes), ready or failed.
next Present when there is something to do first, such as setting up your radar.

An idea written for you can be priced with quote_test by its id, with the same key.