※ 現在APIはベータ版です。仕様が変更になる可能性がありますのでご了承ください。

POST /api/v1/teams
Create team

Supported Formats

json

Examples

POST /api/v1/teams
{
  "team": {
    "name": "created"
  }
}
200
{
  "id": 455,
  "avatar_url": "data:image/png;base64,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",
  "time_limit": 0,
  "name": "created",
  "hierarchized": false,
  "default_duration": 15,
  "created_at": "2025-08-13T09:05:43.000+09:00",
  "updated_at": "2025-08-13T09:05:43.000+09:00",
  "workspaces_workspace_id": 473,
  "ancestry": null,
  "html_url": "http://test.host/app/teams/455/edit",
  "personal": false,
  "is_personal": false,
  "can_manage": true,
  "can_manage_employ": true,
  "descendants_names": [],
  "is_payment_required": false,
  "payment_required": false,
  "price_users_count": 1,
  "payable": true,
  "parent": null,
  "is_custom_fields_allowed": true,
  "custom_fields_limit": 5,
  "rounding": "floor",
  "capacity": null,
  "working_users": [],
  "users": [
    {
      "id": 254,
      "email": "email@example.com",
      "nickname": "name",
      "image": "image",
      "avatar_url": "image",
      "daily": true,
      "weekly": true,
      "calendar_zoom_rate": 1,
      "daily_time": "17:00",
      "has_password": false,
      "html_url": "http://test.host/app/users/254/calendar",
      "is_deactivated": false,
      "membership": {
        "id": 453,
        "team_id": 455,
        "user_id": 254,
        "role": "manager",
        "role_id": 911,
        "created_at": "2025-08-13T09:05:43.000+09:00",
        "updated_at": "2025-08-13T09:05:43.000+09:00",
        "deleted_at": null
      },
      "employ": {
        "id": null,
        "team_id": 455,
        "user_id": 254,
        "rate": 0,
        "period": "hourly",
        "started_at": null,
        "deleted_at": null,
        "created_at": null,
        "updated_at": null,
        "task_id": null,
        "rate_text": "0 yen",
        "user": {
          "id": 254
        },
        "team": {
          "id": 455
        }
      }
    }
  ],
  "children": []
}

Params

Param name Description
team
optional

Validations:

  • Must be a Hash
team[name]
optional

Validations:

  • Must be a String
team[time_limit]
optional

Validations:

  • Must be a number.
team[avatar]
optional

Validations:

  • Must be a String