# List Teams

get ` https://app.mk.io/api/v1/organization/teams`

Returns details of all Teams.

RBAC Capability Required: `core.team.get`

## Authentication

Authorization Bearer

Bearer authentication of the form `Bearer <token>`, where token is your
auth token.

## Response

### 200 A list of all teams

- **kind**  string  Required

The kind of record.

- **value** list of objects [TeamGetSchema](https://docs.mediakind.com/api-reference/management-api/schemas/teamgetschema) Required

List of teams.

- **kind** string  Optional
      
    The kind of record.
  - **metadata** object [TeamMetadataSchema](https://docs.mediakind.com/api-reference/management-api/schemas/teammetadataschema) Required
      
    Team metadata.
      
    - **id** string Required format: uuid
        
      The ID of the resource
    - **name** string Optional
        
      The name of the resource
    - **spec** object [TeamSpecSchemaRead](https://docs.mediakind.com/api-reference/management-api/schemas/teamspecschemaread) Required
        
      Team specification.
      
      - **description** string Optional 0-256 characters
          
        A description of the team.
      - **members** map from strings to object [TeamMemberSchemaRead](https://docs.mediakind.com/api-reference/management-api/schemas/teammemberschemaread) Optional
          
        The list of members.
        
        - [any key] object
            
          - **email** string Required
            
            The email address of the team member
          - **isTeamAdmin** boolean Required
            
            Does this user have the ability to edit this team
          - **name** string Required
            
            The name of the team member
      - **scopes** map from strings to object [TeamScopeSchema](https://docs.mediakind.com/api-reference/management-api/schemas/teamscopeschema) Optional
          
        The set of scopes this team has access to, and the roles on each.
        
        - [any key] object
            
          - **roles** list of strings Required
            
            The names of the roles.

## Errors

- **400 Bad Request**

- **error** object [ErrorDetail](https://docs.mediakind.com/api-reference/management-api/schemas/errordetail) Required
      
    Pertinent information about the error
      
    - **code** string Required
    - **detail** string Required
    - **extraDetail** map from strings to any Optional
    - **ref** string Required
    - **status** integer Required

- **401 Unauthorized**

- **403 Forbidden**

- **404 Not Found**

- **429 Too Many Requests**

- **500 Internal Server Error**