POST /api/v1/teams/:team_id/categories
Create a team category

Examples

POST /api/v1/teams/420/categories
{
  "category": {
    "title": "Category A"
  }
}
200
{
  "id": 932,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 420,
  "created_at": "2025-08-13T09:05:35.000+09:00",
  "updated_at": "2025-08-13T09:05:35.000+09:00",
  "deleted_at": null,
  "description": null,
  "category": true,
  "state": "open",
  "bill": 0,
  "ancestry": null,
  "ancestry_path": "/",
  "ancestry_depth": 0,
  "closed_at": null,
  "color": 1,
  "position": 2,
  "parent_id": null,
  "archived": false,
  "selectable": true,
  "team": {
    "id": 420,
    "name": "Arizona horses",
    "created_at": "2025-08-13T09:05:34.000+09:00",
    "updated_at": "2025-08-13T09:05:35.000+09:00",
    "deleted_at": null,
    "time_limit": 0,
    "avatar_url": "data:image/png;base64,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",
    "ancestry": null,
    "html_url": "http://test.host/app/teams/420/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-08-27T09:05:34.929+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}

POST /api/v1/teams/421/categories
{
  "category": {
    "title": "Category A"
  },
  "parent_id": "934"
}
200
{
  "id": 935,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 421,
  "created_at": "2025-08-13T09:05:35.000+09:00",
  "updated_at": "2025-08-13T09:05:35.000+09:00",
  "deleted_at": null,
  "description": null,
  "category": true,
  "state": "open",
  "bill": 0,
  "ancestry": "934",
  "ancestry_path": "/934/",
  "ancestry_depth": 1,
  "closed_at": null,
  "color": 1,
  "position": 1,
  "parent_id": 934,
  "archived": false,
  "selectable": true,
  "team": {
    "id": 421,
    "name": "North Carolina vixens",
    "created_at": "2025-08-13T09:05:35.000+09:00",
    "updated_at": "2025-08-13T09:05:35.000+09:00",
    "deleted_at": null,
    "time_limit": 0,
    "avatar_url": "data:image/png;base64,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",
    "ancestry": null,
    "html_url": "http://test.host/app/teams/421/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-08-27T09:05:35.201+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}