{"id":"71b6432b-c25a-4712-84bd-203cc9ebafcd","task":"Authenticate to Bob's public API with a service user and read employee data via the People search endpoint.","domain":"apidocs.hibob.com","steps":["In Bob, create a new API Service User to get an ID and token (service users can't log into Bob and exist only to authenticate API calls).","Create a dedicated permission group, add the service user to it, and grant view access to the 'root,' 'about,' 'employment,' and 'work' categories (Default Employee Fields) needed for basic reads.","Fetch field metadata first to learn field IDs, categories, and data types before building your query.","Authenticate each request with the service user ID and token in the Authorization header.","POST to /v1/people/search with a fields array (dot-notation IDs like root.id, work.department) and optional filters to retrieve employee records in one response.","Set showInactive: true in the request when you need terminated, inactive, or former employees, since the default excludes them."],"gotchas":["The search endpoint has no pagination — it returns all matching employees in a single call, so for large companies fetch just root.id first, then batch subsequent calls filtered by id.","If the service user lacks permission for a requested field, the API silently drops it from the response (still HTTP 200) rather than erroring — always verify all expected fields actually came back.","Response keys use slash notation (e.g. /root/id) even though fields are requested using dot notation (root.id) — parsing must account for this mismatch."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/71b6432b-c25a-4712-84bd-203cc9ebafcd"}