Validate the TechZone API token and return the current user's profile (name, email, roles, persona, and API entitlement).

List all of my TechZone reservations with name, status (e.g. Ready, Provisioning, Scheduled, Deleted), environment, region, and start/end dates. Credentials are never included here - use get_reservation for full details on one reservation.

Get full details for one reservation by its id (from list_reservations), including service links, access details, lifecycle dates, and extension count. Output may contain environment credentials - only call this when the user asks about a specific reservation.

Search reservable TechZone collections by name. THIS is how to find something to reserve: pick a result id, inspect it with get_collection (a result with no platforms is an umbrella collection - not reservable), then create_reservation. Distinct from search_catalog, which searches the separate Backstage deployer catalog.

Get a TechZone collection's deployment options (platforms, regions, datacenters, templates) by collection id - from a catalog entry or a reservation's collectionId. Consult this before create_reservation to pick a region.

Create a TechZone reservation from a collection. THIS CHANGES STATE and consumes real environment capacity - always confirm the collection, name, region, and duration with the user before calling. The collection must be a reservable environment (its get_collection output has platforms), not an umbrella collection. template picks the deployment variant and region_name the region, both from get_collection (each defaults to the first available); start is an ISO timestamp (defaults to now); days is the duration (default 2, may be capped by policy). On success returns the new reservation id - poll get_reservation until status is Ready.

Cancel (delete) a TechZone reservation and its environment. THIS IS DESTRUCTIVE AND IRREVERSIBLE - always confirm with the user first. confirm_name must be the reservation's exact name (from list_reservations); the call is refused if it does not match.

Extend a TechZone reservation's end date by N days (default 1) past its current provisionUntil. THIS CHANGES STATE on TechZone - always confirm with the user (reservation name + how many days) before calling. Returns outcome 'extended' (with the new end date), 'not_extendable' (extension limit reached or not allowed for this environment), 'rejected' (request refused, e.g. expired/deleted reservation - nothing applied), or 'ambiguous' (verify with get_reservation).

Flag active reservations ending within the next N days (default 3), soonest first, each with an hoursRemaining countdown. Use this to answer 'is anything about to expire?' - already-deleted/expired reservations are excluded.

Search the TechZone catalog (catalog.techzone.ibm.com) for environments, collections, and products. Returns matching entries with title, kind, owner, and catalog location path.

Get one TechZone catalog entry by kind and name (e.g. kind='system', name='redhat-openshift'). Kind and name come from a search_catalog result's location path: /catalog/{namespace}/{kind}/{name}.