※ 現在APIはベータ版です。仕様が変更になる可能性がありますのでご了承ください。
Teams::Categories
GET /api/v1/teams/:team_id/categories
>>>
Get team categories
Examples
GET /api/v1/teams/23/categories
200
[
{
"id": 81,
"title": "Uncategorized",
"color": 1,
"ancestry_depth": 0,
"team_id": 23,
"created_at": "2025-06-02T16:24:42.000+09:00",
"updated_at": "2025-06-02T16:24:42.000+09:00",
"ancestor_titles": [],
"archived": false,
"selectable": true,
"is_leaf": true
}
]
POST /api/v1/teams/:team_id/categories
>>>
Create a team category
Examples
POST /api/v1/teams/24/categories
{
"category": {
"title": "Category A"
}
}
200
{
"id": 83,
"key": "Category A",
"title": "Category A",
"url": null,
"team_id": 24,
"created_at": "2025-06-02T16:24:42.000+09:00",
"updated_at": "2025-06-02T16:24:42.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": 24,
"name": "New Jersey lycanthropes",
"created_at": "2025-06-02T16:24:42.000+09:00",
"updated_at": "2025-06-02T16:24:42.000+09:00",
"deleted_at": null,
"time_limit": 0,
"avatar_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABAEAIAAAB1mzrKAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0T///////8JWPfcAAAFkklEQVR42u2cf0yUdRzH3w/3A+4OcDGgZlR2CbOFwR+MFrQ5cEzRNqJWCssM6SJTsyBKB64pOmKILQkpwDmQlHJNKs1qg37wIwRi6QhZCJKSMaAivIP7+Tz98ew0jed5IO6+X+/uef3Fnns/3/t8vy++9717vvccw3Hj44mJkKGEH+0CfB1ZAGVkAZSRBVBGFkAZWQBlZAGUUbq6Qa0+Yw+AKe1KqSQX8UcBMPNT47e0B4GpVUcDmrwNHwhnbE93vAbYKn/udO1zu1yARp9ZBDC4g5OMjgCAwz5+DLBOth1ydSVzh6lTLwe0eVkiNZs2X2sAbHC1AOovQYEj+XsBv8W6HtqV0IG6AL8loX2AdujlQtqVUOo/7QJ4AgLSTgGq6djDtCshDWkB/Vz+rMdD0Q4Exe2oci6JvgJhAdMtNY0ixYxFlAHa0Ow2qmNCFMICbMe63gbsq86fEs5ogtc3AcrJqAq6Q0MGwgKYQU0hYAquaBYJpSvCgaBnd0YCTLoinOr4uB3Sa8AX/lPOjzPWxOZ64aCiI1ILaOIzV1MdH7dDegaUqXKcf5viD6UCyLOJfP7UTmQlAIqQe++iND5uh7SAf73DcRSMpgEz6gaNyAm16mggKO7NKgChTDudQXInpF+CytQ5Nx+YTq+9E2C7xw3CJyl7YkIATUq6ivj4uB2KM4CH05uLAJP1PYvUudrTL/0NKFLDs8jW7F5Iz4ADqpzZDluimoYA265Ou/CpjFobAAReyd9LuGa3QnoG7FTVCj9qjNhfCGCtNVg4oxp99BIQEJ6SS7Zyd0F8DZh9BvA4nrraCkxfqHlDqhndllevAH7li7YTrt/l3FYzgId/X2Qf7R8Waad80XanBs+G9Ax4QXlRKsK1sicB49HiAQDVjqXCSf/wlFxAPZpwiXAvXAjpGWCQFsBjzxrcDczU1S+XSgaa89c4l2jPg/QMMCgG5hOfXnZkP+Bo/3WDSBfiwqoBXefmM4T74hJIC3hMkT6fOFds33j95UhoLwEAEBCbvgJQ9cSEEO7RAiEt4EGmdP4n2Yp6lYD5rU8+FgnxWzqrdzz/P7Z0xrkEwuNwHdICFnA9x5T3fhXAFoymiXSHvedJQItN82t6AtS+oH+b7AnPBf6ihXG45CGppEafsQdQdkRq59hyP/s6rV55kAAe67td3wOWfWc+EwnNd0unhW2k1R+PE8Bjaj7YAHCxfyUJZxSTURWAJjijSbK5RscYrZ54qAD2o2uXAWPGgW6ppDZ0Uxug6Iv4QTjDVduXApgAhaXYQwXwWLK/iQGspd99LRKqVUcDgcdz4ySbq7ZHku+DRwvgMaaU+QNck/G4cEZVGX8W8D+cdE44w+VZRTZH3YUXCGAj/iwATFfLJf/HdStfWQ8wU5rkWR8WvQzuLrxAAI859XQWYPuwu1iks3Fh1c6N/v/CPWfpJV+31wjgMQ6XRAPQm4uEM5pz67YCyuz7H775OLfWIs+AheLI+b0EMNVUiS2nBsVFQLd424+3HF8jC3AR5mdO3AfYRe9m4ZdldeUjZ51HuAfE5o278EoBXD+XDxjriwcAFNs3Cid1U1uSAWYZUwpw+hlZgCuxfzpcCUwb6kS2gBSl+q8A/y8fP+K81kQaLxbAM2OoGwQc+UOrhDO6JwxhADMUsIt8fV4vgL/MYDxa/AuAVvbkbBlmJGQfoCqKd/kti9J4vQAeW++FuwFz8olM2pXcio8I4DE1Vo0B7IrfWNqV3MCnBHDxllTA2FXyIu1KbuBTAnisl3v6AcuSz/toVwL4pAAe/vvYrHFikm4dPiuAPW/aBphiy5IW3tZC8FkBPJaOFp3U3WruxccF8Bi3vnMQ4HZPrSP/3Iz8s5V0kWcAZWQBlJEFUEYWQBlZAGVkAZSRBVBGFkCZfwAm2qEXJNWnNwAAAABJRU5ErkJggg==",
"personal": false,
"premium": false,
"ancestry": null,
"rounding": "floor",
"capacity": null,
"html_url": "http://test.host/app/teams/24/edit",
"descendants_names": [],
"payment_required": false,
"price_users_count": 1,
"payable": true,
"free_ends_at": "2025-06-16T16:24:42.493+09:00",
"can_manage": true,
"can_manage_employ": true
}
}
POST /api/v1/teams/25/categories
{
"category": {
"title": "Category A"
},
"parent_id": "85"
}
200
{
"id": 86,
"key": "Category A",
"title": "Category A",
"url": null,
"team_id": 25,
"created_at": "2025-06-02T16:24:42.000+09:00",
"updated_at": "2025-06-02T16:24:42.000+09:00",
"deleted_at": null,
"description": null,
"category": true,
"state": "open",
"bill": 0,
"ancestry": "85",
"ancestry_path": "/85/",
"ancestry_depth": 1,
"closed_at": null,
"color": 1,
"position": 1,
"parent_id": 85,
"archived": false,
"selectable": true,
"team": {
"id": 25,
"name": "Maryland gnomes",
"created_at": "2025-06-02T16:24:42.000+09:00",
"updated_at": "2025-06-02T16:24:42.000+09:00",
"deleted_at": null,
"time_limit": 0,
"avatar_url": "data:image/png;base64,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",
"personal": false,
"premium": false,
"ancestry": null,
"rounding": "floor",
"capacity": null,
"html_url": "http://test.host/app/teams/25/edit",
"descendants_names": [],
"payment_required": false,
"price_users_count": 1,
"payable": true,
"free_ends_at": "2025-06-16T16:24:42.774+09:00",
"can_manage": true,
"can_manage_employ": true
}
}
PATCH /api/v1/teams/:team_id/categories/:id
>>>
Update a team category
Examples
PATCH /api/v1/teams/26/categories/88
{
"category": {
"title": "Category A"
}
}
200
{
"id": 88,
"key": "CategoryA",
"title": "Category A",
"url": null,
"team_id": 26,
"created_at": "2025-06-02T16:24:43.000+09:00",
"updated_at": "2025-06-02T16:24:43.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": 26,
"name": "Vermont wolves",
"created_at": "2025-06-02T16:24:43.000+09:00",
"updated_at": "2025-06-02T16:24:43.000+09:00",
"deleted_at": null,
"time_limit": 0,
"avatar_url": "data:image/png;base64,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",
"personal": false,
"premium": false,
"ancestry": null,
"rounding": "floor",
"capacity": null,
"html_url": "http://test.host/app/teams/26/edit",
"descendants_names": [],
"payment_required": false,
"price_users_count": 1,
"payable": true,
"free_ends_at": "2025-06-16T16:24:43.052+09:00",
"can_manage": true,
"can_manage_employ": true
}
}