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

Examples

POST /api/v1/teams/447/categories
{
  "category": {
    "title": "Category A"
  }
}
200
{
  "id": 1204,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 447,
  "created_at": "2025-10-02T10:15:50.000+09:00",
  "updated_at": "2025-10-02T10:15:50.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": 447,
    "name": "Tennessee crows",
    "created_at": "2025-10-02T10:15:50.000+09:00",
    "updated_at": "2025-10-02T10:15:50.000+09:00",
    "deleted_at": null,
    "time_limit": 0,
    "avatar_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABAEAIAAAB1mzrKAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0T///////8JWPfcAAABQUlEQVR42u3coU7DUBxG8e82ywKIScwswRIUFgECsUeYw8+gZnFYMLNTCBxiL4BhagIDAr0pJIZQXmBiycpOBudnb3Lzb096RZO21PVk0utFkIoe4L8zAMwAMAPADAAzAMwAsFZzW5WL8pjkterSF/XrBt+jpB7Uo/W3ajDA/uVJPzk+HI65O7MZ887TbjLLzfn6e3kEwQwAMwDMALCybW9Dz3buj5LW6d71stWPg5e35PlueEXPuSqfAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQBmAJgBYAaAGQDW4N9SNuP962GRVGmXZauf08Vtkik95eq27kv5v8YjCGYAmAFgBoAZAGYAmAFgP26sJ/jJKes2AAAAAElFTkSuQmCC",
    "ancestry": null,
    "html_url": "http://test.host/app/teams/447/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-10-16T10:15:50.326+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}

POST /api/v1/teams/448/categories
{
  "category": {
    "title": "Category A"
  },
  "parent_id": "1206"
}
200
{
  "id": 1207,
  "key": "Category A",
  "title": "Category A",
  "url": null,
  "team_id": 448,
  "created_at": "2025-10-02T10:15:50.000+09:00",
  "updated_at": "2025-10-02T10:15:50.000+09:00",
  "deleted_at": null,
  "description": null,
  "category": true,
  "state": "open",
  "bill": 0,
  "ancestry": "1206",
  "ancestry_path": "/1206/",
  "ancestry_depth": 1,
  "closed_at": null,
  "color": 1,
  "position": 1,
  "parent_id": 1206,
  "archived": false,
  "selectable": true,
  "team": {
    "id": 448,
    "name": "Idaho penguins",
    "created_at": "2025-10-02T10:15:50.000+09:00",
    "updated_at": "2025-10-02T10:15:50.000+09:00",
    "deleted_at": null,
    "time_limit": 0,
    "avatar_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABAEAIAAAB1mzrKAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0T///////8JWPfcAAAA/ElEQVR42u3cMUpDQQBF0YlYpVdQMEUKt6DZgcEFpHAxqdJqY2FvLbhAk+8KAr87iPfUUzy4zJSzmKbdbr0eQS70gP+uAFgBsAJgBcAKgBUAu9QD5nt4216Psbq9fzp/5uvn/W6M08vxoNfO9YcCPL5ur8bYTM/782e+Pz9uxjiN41KvnasnCCsAVgCsAFgBsAJgBcAKgBUAKwBWAKwAWAGwAmAFwAqAFQArAFYArABYAbACYAXACoAVACsAVgCsAFgBsAJgBcAKgBUAKwBWAKwAWAGwAmAFwAqAFQArAFYArABYAbBF31Za3QCsAFgBsAJgBcAKgBUAKwD2Cy4hFJIch6C1AAAAAElFTkSuQmCC",
    "ancestry": null,
    "html_url": "http://test.host/app/teams/448/edit",
    "descendants_names": [],
    "payment_required": false,
    "price_users_count": 1,
    "payable": true,
    "free_ends_at": "2025-10-16T10:15:50.579+09:00",
    "can_manage": true,
    "can_manage_employ": true,
    "rounding": "floor",
    "capacity": null,
    "premium": false,
    "personal": false
  }
}