Coolify Octri Demo
GET/teams/{id}

Get a team by ID

Retrieves a team by its ID. Use this endpoint when you need a specific team's details, settings, and members.

1 parameter
idintegerrequired
The integer ID of the team to retrieve.

4 status codes
200Returns the team, including its ID, name, description, settings, and members.
created_atstringoptional
The date and time the team was created.
custom_server_limitstringoptional
The custom server limit.
descriptionstringoptional
The description of the team.
idintegeroptional
The unique identifier of the team.
is_build_server_fallback_enabledbooleanoptional
Whether deployments can fall back to the deployment server when no usable dedicated build server is available.
membersarray<object>optional
The members of the team.
namestringoptional
The name of the team.
personal_teambooleanoptional
Whether the team is personal or not.
show_boardingbooleanoptional
Whether to show the boarding screen or not.
updated_atstringoptional
The date and time the team was last updated.
400Returned when the API token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when the team resource is not found.
messagestringoptional

Error handling

A 400 is returned when the API token is invalid; a 401 when the request is unauthenticated; and a 404 when the resource is not found. The id path parameter is the integer ID of the team to retrieve.