> ## Documentation Index > Fetch the complete documentation index at: https://docs.16tms.com/llms.txt > Use this file to discover all available pages before exploring further. # Update team > Updates an existing team's information. ## OpenAPI ````yaml /api-reference/teams/openapi.json put /teams/{teamId} openapi: 3.0.0 info: title: Teams version: 1.0.0 description: API endpoints for managing teams in the 16TMS platform servers: - url: https://api.16tms.com/api/v1 description: Production server security: - ApiKeyAuth: [] paths: /teams/{teamId}: put: summary: Update team description: Updates an existing team's information. operationId: updateTeam parameters: - name: teamId in: path description: The unique identifier of the team required: true schema: type: string format: uuid example: e86e814e-ca93-412e-b347-fb71837c6466 - name: externalId in: query description: External user ID for API key context required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateTeamRequest' example: name: boss official logo: string coverImage: string description: string gameId: 8a7b084c-d30a-40e7-85e0-865164a9076b responses: '200': description: Team updated successfully content: application/json: schema: $ref: '#/components/schemas/UpdateTeamResponse' example: success: true message: Team updated successfully data: teamId: e86e814e-ca93-412e-b347-fb71837c6466 name: boss official description: string teamSize: 16 ownerId: cbf66c47-a05a-457c-9d3f-322ddd04d79a ownerName: Dhruv logo: string coverImage: string gameId: 8a7b084c-d30a-40e7-85e0-865164a9076b gameName: Counter Stirke gameImage: >- https://metaninzamedia.blob.core.windows.net/media/games/20260211055726_cs2.webp members: - userId: cbf66c47-a05a-457c-9d3f-322ddd04d79a email: '' username: dfs role: 1 joinedAt: '2026-02-11T05:59:42.710198Z' profileImage: strsdfsding gameId: 8a7b084c-d30a-40e7-85e0-865164a9076b userGameId: Bossxdhruv meta: traceId: 00-fb61aeecb9154e9e1f1ff1cf32324afc-135e8e98ffea0f69-00 elapsedMs: 19.47 serverTimestamp: '2026-02-11T06:00:13.9368803Z' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Team not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyAuth: [] components: schemas: UpdateTeamRequest: type: object properties: name: type: string description: Name of the team logo: type: string description: URL to the team's logo image nullable: true coverImage: type: string description: URL to the team's cover image nullable: true description: type: string description: Description of the team nullable: true gameId: type: string format: uuid description: ID of the game this team is associated with UpdateTeamResponse: type: object properties: success: type: boolean message: type: string data: $ref: '#/components/schemas/TeamDetail' meta: type: object properties: traceId: type: string elapsedMs: type: number serverTimestamp: type: string format: date-time ErrorResponse: type: object properties: success: type: boolean description: Indicates if the request was successful example: false message: type: string description: Error message describing what went wrong example: Invalid API key errors: type: array description: Detailed error information items: type: object properties: field: type: string description: The field that caused the error example: name message: type: string description: Description of the error example: This field is required meta: type: object properties: traceId: type: string description: Unique trace identifier for debugging purposes serverTimestamp: type: string format: date-time description: Server timestamp when the error occurred TeamDetail: type: object properties: teamId: type: string format: uuid name: type: string description: type: string nullable: true teamSize: type: integer ownerId: type: string format: uuid ownerName: type: string logo: type: string nullable: true coverImage: type: string nullable: true gameId: type: string format: uuid gameName: type: string gameImage: type: string nullable: true members: type: array items: $ref: '#/components/schemas/TeamMember' TeamMember: type: object properties: userId: type: string format: uuid description: Unique identifier for the user example: 302cb943-26a3-40e1-92f4-216ac2b264d7 externalId: type: string description: External identifier for the user nullable: true example: null email: type: string format: email description: Email address of the team member example: '' username: type: string description: Username of the team member example: dhruvpatel role: $ref: '#/components/schemas/TeamRole' joinedAt: type: string format: date-time description: Timestamp when the member joined the team example: '2026-02-09T13:22:47.392121Z' profileImage: type: string format: uri description: URL to the member's profile image example: null nullable: true gameId: type: string format: uuid description: ID of the game example: 3b1dd428-f288-4654-beff-ae523005f47a userGameId: type: string description: User's in-game ID example: bossxdhruv TeamRole: type: integer description: Role of the member in the team (1 = Owner, 3 = Member) enum: - 1 - 3 x-enum-varnames: - Owner - Member x-enum-descriptions: - Team Owner - Team Member securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY description: >- API key for authentication. You can generate this from the 16TMS console. ````