Sign in

v22

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-04970425.1 KB
Teams

Update a team

Update the team information by ID.

patch/teams/{team_id}

Path parameters

team_idstring required

Request body

client_read_only_metadataobject nullable

Client read-only, server-writable metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client. The client can read this data, but cannot modify it. This is useful for things like subscription status.

server_metadataobject nullable

Server metadata. Used as a data store, only accessible from the server side. You can store secret information related to the team here.

display_namestring

Human-readable team display name. This is not a unique identifier.

profile_image_url'null' nullable

URL of the profile image for team. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.

client_metadataobject nullable

Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.

Example request

{
  "client_read_only_metadata": {
    "key": "value"
  },
  "server_metadata": {
    "key": "value"
  },
  "display_name": "My Team",
  "profile_image_url": "https://example.com/image.jpg",
  "client_metadata": {
    "key": "value"
  }
}

Response

Successful response

created_at_millisnumber required

The time the team was created (the number of milliseconds since epoch, January 1, 1970, UTC)

server_metadataobject nullable

Server metadata. Used as a data store, only accessible from the server side. You can store secret information related to the team here.

idstring required

The unique identifier of the team

display_namestring required

Human-readable team display name. This is not a unique identifier.

profile_image_url'null' nullable

URL of the profile image for team. Can be a Base64 encoded image. Must be smaller than 100KB. Please compress and crop to a square before passing in.

client_metadataobject nullable

Client metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client.

client_read_only_metadataobject nullable

Client read-only, server-writable metadata. Used as a data store, accessible from the client side. Do not store information that should not be exposed to the client. The client can read this data, but cannot modify it. This is useful for things like subscription status.

Example response

{
  "created_at_millis": 1630000000000,
  "server_metadata": {
    "key": "value"
  },
  "id": "ad962777-8244-496a-b6a2-e0c6a449c79e",
  "display_name": "My Team",
  "profile_image_url": "https://example.com/image.jpg",
  "client_metadata": {
    "key": "value"
  },
  "client_read_only_metadata": {
    "key": "value"
  }
}