The Get team endpoint returns details for a single team.

Requirements: Base URL, Authentication, Error codes

Scope: users.teams.read

What this does

When you send a Get team request with a team ID,

When to use it

• Retrieve a team after you have its ID from Get list of teams
• Display team details in an admin or reporting tool
• Validate that a team exists and is accessible to your API key

Prerequisites

• The team must exist in the contact center.
• You must have access to the team.

Endpoint

GET /api/v4/teams/{team_id}

Path parameters

• team_id
  The unique identifier of the team.

Examples

Minimal request

curl -X GET "https://{cluster_id}.voiso.com/api/v4/teams/3" \
  -H "Authorization: Bearer <contact_center_api_key>" \
  -H "Content-Type: application/json"

Response

If successful, the API returns a team object.

{
  "team": {
    "id": 3,
    "name": "Multilingual Support"
  }
}

Troubleshooting

401 Unauthorized

What to check:

• You are sending Authorization: Bearer <contact_center_api_key>.
• Your Base URL includes the correct {cluster_id}.

Example response:

{ "error": "Unauthorized" }

403 Forbidden

What to check:

• The API key is valid, but does not have access to this team.

Example response:

{ "error": "Forbidden" }

404 Not found

This usually means the team ID does not exist, or you do not have access to it.

What to check:

• Confirm the team ID using Get list of teams.

Example response:

{ "error": "Not found" }

429 Too many requests

What to do:

• Reduce request frequency and retry with backoff.

Example response:

{ "error": "Too many requests" }