Troubleshooting

// ❌ Wrong
{"task_id": "abc", "status": "created"}

// ✅ Correct
{"result": {"task_id": "abc", "status": "created"}}

"additional_auth_params": {
  "access_type": "offline",
  "prompt": "consent"
}

from fastapi import Header
from typing import Optional

async def handle(x_orceum_installation_id: Optional[str] = Header(None)):
    ...

user = await db.get_user_by_installation_id(x_orceum_installation_id)

// ❌ Vague
"description": "Creates a task"

// ✅ Clear trigger
"description": "Create a new task or to-do item. Use when the user wants to add work to their list, set a reminder, or track something they need to do."

{
  "auth_header_key": "Authorization",
  "authentication_scheme": "Bearer"
}

@app.post("/actions")
async def handle(request: Request):
    body = await request.json()
    if body["event"] == "export_data":
        job_id = await enqueue_export(body["event_data"])
        return {"result": {
            "status": "processing",
            "job_id": job_id,
            "message": "Export started. I'll notify you when it's ready."
        }}