Skip to main content
Teams

Get team by ID

Retrieves a single team by its Featurebase ID.

GET
/v2/teams/{id}

Path Parameters

  • id - The Featurebase internal ID of the team (MongoDB ObjectId)

Response

Returns a team object with:

  • id - Unique team identifier
  • name - Team display name
  • color - Team color in hex format
  • icon - Team icon (emoji, predefined, or external URL)
  • members - Array of admin IDs who are members of this team

Example Response

{
  "object": "team",
  "id": "507f1f77bcf86cd799439011",
  "name": "Support Team",
  "color": "#3B82F6",
  "icon": {
    "value": "👥",
    "type": "emoji"
  },
  "members": ["5fef50c5e9458a0012f82456", "5fef50c5e9458a0012f82457"]
}

Error Responses

  • 404 Not Found - Team with the specified ID does not exist

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

The Featurebase internal ID of the team (MongoDB ObjectId)

Example: 507f1f77bcf86cd799439011

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

colorstringrequired

Team color in hex format

Example: #3B82F6
iconobject | nullrequired

Team icon

idstringrequired

Unique identifier

Example: 507f1f77bcf86cd799439011
membersstring[]required

Array of admin IDs who are members of this team

namestringrequired

Team name

Example: Support Team
objectenum<string>required

Object type identifier

Available options: team
Example: team

Still need help? Ask the team