Update a team
/api/v1/teams/{team_id}Update selected team orchestration fields. Omitted fields are unchanged. Use the atomic member-replacement operation to change the ordered member set.
Required access
Credentials: service principal, delegated token, user session
Scope: teams:edit
A delegated token may update only a team owned by its user. Teams are organization-visible, so a service principal with teams:edit may update one unless its resource allowlist excludes it.
An organization-owned automation key, prefixed gsmc_sk_. Already bound to one organization, so it needs no X-Org-Id header. It carries no user identity: it never reaches a private resource however it is scoped, and a run it starts has no user for an interactive tool to reach.
In: header
Path Parameters
uuidHeader Parameters
Selects the active organization for a credential that belongs to more than one. Service-principal keys are bound to a single organization and ignore it.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for updating a team.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/api/v1/teams/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "description": "Coordinates gated release checks.", "execution_profile": "review_verify" }'{ "team": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b", "owner_user_id": "65139110-7c3c-4777-b692-80c218be3b9d", "name": "string", "description": "string", "input_schema": {}, "output_schema": {}, "execution_profile": "map_reduce", "workforce_config": { "execution_profile": "map_reduce", "allowed_worker_roles": [ "string" ], "runtime_policy": { "max_fan_out": 5, "expected_children": 1, "max_failed_children": 0, "ownership_mode": "explicit_scope", "merge_strategy": "collect_array", "verification_policy": { "mode": "none", "child_output_schema": {}, "require_all_children_success": true }, "straggler_timeout_seconds": 120, "replication_policy": "none", "budget_policy": { "max_total_tokens": 1, "max_duration_seconds": 1 }, "bootstrap_policy": { "enabled": true, "planner_budget_fraction": 0.2, "planner_timeout_seconds": 120 }, "allow_decentralized_claims": false, "max_messages_per_child": 1 }, "artifact_input_mapping": [ { "source_alias": "string", "target_alias": "string", "worker_agent_ids": [ "692ece4d-fec3-48e8-86b4-13504d7d05ca" ] } ] }, "members": [], "is_active": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}