※ 現在APIはベータ版です。仕様が変更になる可能性がありますのでご了承ください。
Teams::Categories
GET /api/v1/teams/:team_id/categories
>>>
Get team categories
Examples
GET /api/v1/teams/446/categories
200
[
{
"id": 1202,
"title": "Uncategorized",
"color": 1,
"ancestry_depth": 0,
"team_id": 446,
"created_at": "2025-10-02T10:15:50.000+09:00",
"updated_at": "2025-10-02T10:15:50.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/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
}
}
PATCH /api/v1/teams/:team_id/categories/:id
>>>
Update a team category
Examples
PATCH /api/v1/teams/449/categories/1209
{
"category": {
"title": "Category A"
}
}
200
{
"id": 1209,
"key": "CategoryA",
"title": "Category A",
"url": null,
"team_id": 449,
"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": 449,
"name": "Wisconsin pigs",
"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,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",
"ancestry": null,
"html_url": "http://test.host/app/teams/449/edit",
"descendants_names": [],
"payment_required": false,
"price_users_count": 1,
"payable": true,
"free_ends_at": "2025-10-16T10:15:50.838+09:00",
"can_manage": true,
"can_manage_employ": true,
"rounding": "floor",
"capacity": null,
"premium": false,
"personal": false
}
}