---
title: "Search channels"
method: POST
path: "/api/v4/teams/{team_id}/channels/search"
tags: ["channels"]
---

# Search channels

`POST /api/v4/teams/{team_id}/channels/search`

Search public channels on a team based on the search term provided in the request body.
##### Permissions
Must have the `list_team_channels` permission.

A user without the `list_team_channels` permission will be able to use this endpoint, with the search results limited to the channels that the user is a member of.

## Path parameters

- `team_id` string, required

## Request body

- object
  - `term` string, required — The search term to match against the name or display name of channels

## Response `201`

Channels search successful

- 38cb7293Channel[]
  - `id` string
  - `create_at` integer — The time in milliseconds a channel was created
  - `update_at` integer — The time in milliseconds a channel was last updated
  - `delete_at` integer — The time in milliseconds a channel was deleted
  - `team_id` string
  - `type` string
  - `display_name` string
  - `name` string
  - `header` string
  - `purpose` string
  - `last_post_at` integer — The time in milliseconds of the last post of a channel
  - `total_msg_count` integer
  - `creator_id` string

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `401` — No access token provided
- `403` — Do not have appropriate permissions
- `404` — Resource not found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/158a854b0c7d/schema)