AI Tasks API

Retrieve a list of all AI tasks available to the authenticated user. Includes both system-default tasks and custom tasks shared with the user's groups.

GET /api/ai/tasks?category=hr-comms
Authorization: Bearer YOUR_API_KEY

{
  "tasks": [
    {
      "id": "policy-translator",
      "name": "Translate Policy to Plain Language",
      "description": "Convert legal/HR policy text into simple, employee-friendly language",
      "category": "hr-comms",
      "icon": "📋",
      "requiresFile": true,
      "maxTokens": 1500,
      "temperature": 0.7,
      "isSystemDefault": true,
      "isActive": true,
      "variablesSchema": [
        {
          "name": "content",
          "type": "string",
          "required": false,
          "description": "Policy text to translate (optional if using file upload)"
        }
      ]
    },
    {
      "id": "memo-drafter",
      "name": "Draft Internal Memo",
      "description": "Write professional internal communications and announcements",
      "category": "hr-comms",
      "icon": "✍️",
      "requiresFile": false,
      "maxTokens": 800,
      "temperature": 0.7,
      "isSystemDefault": true,
      "isActive": true,
      "variablesSchema": [
        {
          "name": "topic",
          "type": "string",
          "required": true,
          "description": "Subject of the memo"
        },
        {
          "name": "audience",
          "type": "string",
          "required": true,
          "description": "Target audience (e.g., 'all employees', 'HR team')"
        },
        {
          "name": "tone",
          "type": "string",
          "required": true,
          "description": "Desired tone (e.g., 'professional', 'casual', 'urgent')"
        }
      ]
    }
  ],
  "total": 20,
  "category": "hr-comms"
}