Update Account Team
Updates information for a specified team in your account.
Endpoint
POST
v5/accountteams/{team_id}
Requires authentication
Path Parameters
The team to update.
team_id
string
required
The ID of the team to update.
Query Parameters
At least one of the following parameters must be provided.
team_name
string
A new name for the team.
description
string
A new description for the team.
default_role
integer
The ID of the default role to assign to team members. Standard role IDs range from 2–6.
Response
Returns the updated team object.
result_ok
boolean
Whether the request succeeded.
data
object
The updated account team object.
child attributes
id
integer
The unique ID of the team.
team_name
string
The name of the team after the update.
description
string
A description of the team. Defaults to null if not set.
default_role
integer
The ID of the default role assigned to team members. Defaults to 0.
status
string
The status of the team. Possible values:
Active, Deleted.Examples
Request (cURL)
curl -X POST "https://api.alchemer.com/v5/accountteams/YOUR_TEAM_ID?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&team_name=Team+5&default_role=5167"
Response
{
"result_ok": true,
"data": {
"id": 498288,
"team_name": "Team 5",
"description": null,
"default_role": 0,
"status": "Active"
}
}