DevZero Logo
DevZero

Create a team

POST
/teams
/teams

Request Body

application/jsonRequired

create team body

name
Required
string

Display name of team

Minimum length: 1

namespacestring

unique name for team, derived from name if not provided

Pattern: "^[a-z0-9-]+$"

Header Parameters

Authorization
Required
string

Value: "Bearer <token>"; visit the "User Settings" page in the DevZero dashboard to generate a token

curl -X POST "https://api.devzero.io/backend/v0/teams" \
  -H "Authorization: string" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "namespace": "string"
  }'

OK

{
  "arc_dashboard": {
    "is_ready": true,
    "type": "string",
    "url": "string"
  },
  "available_regions": [
    {
      "id": "string",
      "latitude": 0,
      "longitude": 0,
      "name": "string",
      "provided_by": "string",
      "slug": "string"
    }
  ],
  "base_image_tag": "string",
  "dora_dashboard": {
    "is_ready": true,
    "type": "string",
    "url": "string"
  },
  "environment_variables": [
    {
      "is_secret": true,
      "name": "string",
      "value": "string"
    }
  ],
  "id": "string",
  "invite_token": "string",
  "name": "string",
  "namespace": "string",
  "oda_dashboard": {
    "is_ready": true,
    "type": "string",
    "url": "string"
  },
  "payment_type": "FREE",
  "product": "FREE",
  "usage_dashboard": {
    "is_ready": true,
    "type": "string",
    "url": "string"
  },
  "users": [
    {
      "default_region": "string",
      "default_region_name": "string",
      "dora_connection_ids": [
        "string"
      ],
      "dxi_onboarding_checklist": {
        "analyze_own_code": "SKIPPED",
        "development_process_bottlenecks": "SKIPPED",
        "devzero_cli": "SKIPPED",
        "github_token": "SKIPPED",
        "is_dora_repository_connected": true
      },
      "email": "user@example.com",
      "given_name": "string",
      "id": "string",
      "is_global_admin": true,
      "linked_vcss": [
        {
          "link_metadata": "string",
          "vsc_uri": "string"
        }
      ],
      "onboarding_checklist": {
        "has_completed_onboarding": true,
        "has_completed_onboarding_checklist": true,
        "has_completed_recipe_quick_starters": true,
        "has_created_recipe": true,
        "has_dismissed_quickstart": true,
        "has_dismissed_recipe_callout": true,
        "has_forked_quickstart": true,
        "has_launched_workspace": true,
        "has_seen_github_app_modal": true,
        "has_seen_onboarding_recipe_modal": true,
        "onboarding_path": "undefined"
      },
      "organization_join_date": 0,
      "sub": "string",
      "teams": [
        {
          "authorized_oauth2_repo_manager_integrations": [
            "string"
          ],
          "connected_github_user": "string",
          "connected_github_user_url": "string",
          "gh_user_access_token": "string",
          "is_owner": true,
          "name": "string",
          "permissions": "string",
          "role": "string",
          "team_id": "string",
          "user_id": "string"
        }
      ],
      "timezone": "string",
      "user_scoped_recipe": "string"
    }
  ],
  "workspaces_are_private": true
}