Sample - Slack Web API
GET/admin.teams.list

List Enterprise organization teams

Lists all teams in an Enterprise organization. Use cursor to retrieve subsequent pages and limit to control the number of teams returned per request. Authenticate with a token that has the admin.teams:read scope.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
limitintegeroptional
The maximum number of teams to return. Must be between 1 and 100 inclusive.
cursorstringoptional
The `next_cursor` value returned by the previous response to retrieve the next page.
tokenstringrequired
Authentication token with the `admin.teams:read` scope.

2 status codes
200Returns a successful response containing the Enterprise organization team results with `ok` set to true.
okbooleanrequired
Allowed:true
defaultReturns the standard failure response with `ok` set to false.
okbooleanrequired
Allowed:false

Error handling

token must carry the admin.teams:read scope. When provided, limit must be between 1 and 100 inclusive, and cursor must contain the next_cursor value from the previous response to continue listing teams.