※ 現在APIはベータ版です。仕様が変更になる可能性がありますのでご了承ください。
Teams::Categories
GET /api/v1/teams/:team_id/categories
>>>
Get team categories
Examples
GET /api/v1/teams/419/categories
200
[
{
"id": 930,
"title": "Uncategorized",
"color": 1,
"ancestry_depth": 0,
"team_id": 419,
"created_at": "2025-08-13T09:05:34.000+09:00",
"updated_at": "2025-08-13T09:05:34.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/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
}
}
PATCH /api/v1/teams/:team_id/categories/:id
>>>
Update a team category
Examples
PATCH /api/v1/teams/422/categories/937
{
"category": {
"title": "Category A"
}
}
200
{
"id": 937,
"key": "CategoryA",
"title": "Category A",
"url": null,
"team_id": 422,
"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": 422,
"name": "Arizona nemesis",
"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/422/edit",
"descendants_names": [],
"payment_required": false,
"price_users_count": 1,
"payable": true,
"free_ends_at": "2025-08-27T09:05:35.507+09:00",
"can_manage": true,
"can_manage_employ": true,
"rounding": "floor",
"capacity": null,
"premium": false,
"personal": false
}
}