What this does

When you send a Get team request with a team ID, Voiso returns the team object for that team.

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" }