# Team

## Get all teams associated with user

> \## Team Resource Fields\
> \
> \| Field |\
> \| :--- |\
> \| \`id\` |\
> \| \`created\_at\` |\
> \| \`name\` |\
> \| \`description\` |\
> \| \`belongs\_to\_\_organization\` |\
> \
> \
> \---\
> \
> \`GET /v7/team\`

```json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/team":{"get":{"tags":["Team"],"summary":"Get all teams associated with user","description":"## Team Resource Fields\n\n| Field |\n| :--- |\n| `id` |\n| `created_at` |\n| `name` |\n| `description` |\n| `belongs_to__organization` |\n\n\n---\n\n`GET /v7/team`"}}}}
```

## Create a new team in organization

> \`POST /v7/team\`\
> \
> \*\*Request Body:\*\*\
> \`\`\`json\
> {\
> &#x20;   "name": \<TEAM NAME>,\
> &#x20;   "belongs\_to\_\_organization": \<ORG ID>\
> }\
> \`\`\`

````json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/team":{"post":{"tags":["Team"],"summary":"Create a new team in organization","description":"`POST /v7/team`\n\n**Request Body:**\n```json\n{\n    \"name\": <TEAM NAME>,\n    \"belongs_to__organization\": <ORG ID>\n}\n```","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}}}}}}
````

## Get team by ID

> \`GET /v7/team(\<ID>)\`

```json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/team({ID})":{"get":{"tags":["Team"],"summary":"Get team by ID","description":"`GET /v7/team(<ID>)`","parameters":[{"name":"ID","in":"path","required":true}]}}}}
```

## Delete team with ID

> \`Delete /v7/team(\<ID>)\`

```json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/team({ID})":{"delete":{"tags":["Team"],"summary":"Delete team with ID","description":"`Delete /v7/team(<ID>)`","parameters":[{"name":"ID","in":"path","required":true}]}}}}
```