# Assign a team member `POST /api/v1/teams_objects` Adds an athlete, coach, director, or staff member to a team. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Teams → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the team belongs to. ## Body parameters - `team_id` (integer, required) — ID of the team in the selected sport. - `object_type` (string, required) — One of `athlete`, `coach`, `director`, or `staff`. Athletes and coaches must belong to the selected sport. - `object_id` (integer, required) — ID of the athlete or personnel record. - `action` (string, required) — Set to `assign`. ## Request Set ASDINCLOUD_API_KEY and SPORT_ID. Replace the example IDs with the team and member you intend to change. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/teams_objects" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: $SPORT_ID" \ --header "Content-Type: application/json" \ --data '{"team_id":12,"object_type":"athlete","object_id":24,"action":"assign"}' ``` ## Response **201 Created** Returns a confirmation. The message key depends on the member type. Example with fictional data and selected fields. ```json { "message_key": "entities.team_object.messages.assigned_athlete" } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks one or more required permissions. - `400` — The request was invalid or the member is already assigned. - `404` — The team or member could not be found for the selected sport and member type. - `500` — The membership change could not be completed.