API referenceTeams
Retrieve a team
GET
/api/v1/teams/{team_id}Get a team by ID (must belong to the caller's active org).
Required access
Credentials: service principal, delegated token, user session
Scope: teams:read
AuthorizationBearer <token>
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
team_id*Team Id
Format
uuidHeader Parameters
X-Org-Id?|
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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/teams/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "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 } }, "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"}