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

Examples

POST /api/v1/teams/382/categories
{
  "category": {
    "title": "Category A"
  }
}
200
{
  "id": 842,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 382,
  "created_at": "2025-10-21T11:07:13.000+09:00",
  "updated_at": "2025-10-21T11:07:13.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": 382,
    "name": "Utah spiders",
    "created_at": "2025-10-21T11:07:13.000+09:00",
    "updated_at": "2025-10-21T11:07:13.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/382/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-11-04T11:07:13.549+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}

POST /api/v1/teams/383/categories
{
  "category": {
    "title": "Category A"
  },
  "parent_id": "844"
}
200
{
  "id": 845,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 383,
  "created_at": "2025-10-21T11:07:13.000+09:00",
  "updated_at": "2025-10-21T11:07:13.000+09:00",
  "deleted_at": null,
  "description": null,
  "category": true,
  "state": "open",
  "bill": 0,
  "ancestry": "844",
  "ancestry_path": "/844/",
  "ancestry_depth": 1,
  "closed_at": null,
  "color": 1,
  "position": 1,
  "parent_id": 844,
  "archived": false,
  "selectable": true,
  "team": {
    "id": 383,
    "name": "Mississippi ghosts",
    "created_at": "2025-10-21T11:07:13.000+09:00",
    "updated_at": "2025-10-21T11:07:13.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/383/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-11-04T11:07:13.809+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}