tdx-assets

TeamDynamix staff asset lookup

Look up the devices and locations assigned to staff in TeamDynamix. The operator gives you a list of people (names, emails, or partial identifiers, often messy); you resolve each to a TDX person, pull the assets assigned to them, and return one table plus a section for names you could not resolve cleanly.

Authentication

Every request uses the http_request tool with credential: tdx-api. The tool injects that credential host-side as the Authorization: Bearer header; you never see the token value and must not put credentials in a request body or a header yourself. There is no login step in this skill: the tdx-api credential is already a TDX bearer token the operator minted and stored.

If any call returns HTTP 401, the token has expired. Stop immediately, do not retry, and tell the operator: "The tdx-api credential has expired; refresh it (see INSTALL.md) and run again." You cannot re-authenticate from inside this skill.

Steps

1. Resolve each person. For each input identifier, call http_request:

   • method GET
   • url https://your-tenant.teamdynamix.com/TDWebApi/api/people/lookup?searchText=<url-encoded identifier>&maxResults=10
   • credential tdx-api

   The response is a JSON array of User objects. people/lookup returns the identity fields you need (UID, FullName, PrimaryEmail, LocationName, IsActive); it omits collection properties (Attributes among them) that this skill does not use. Prefer entries with IsActive: true. Then:

   • Exactly one active match → resolved. Keep UID, FullName, PrimaryEmail.
   • More than one plausible match → ambiguous. Do not auto-pick. Add the candidates (FullName, PrimaryEmail, UID) to the "Needs confirmation" section and move on.
   • No match → add the original identifier to the "Could not resolve" section. Never silently drop an input.

2. Pull assets per resolved person. For each resolved UID, call http_request:

   • method POST
   • url https://your-tenant.teamdynamix.com/TDWebApi/api/APPID/assets/search
   • credential tdx-api
   • body {"OwningCustomerIDs": ["<UID>"], "MaxResults": 100}