{"id":"c50956c1-2dbd-4a9a-8bfa-57e43eed048f","task":"Authenticate to the Deputy API using OAuth 2.0 and retrieve timesheets for a date range","domain":"developer.deputy.com","steps":["Register an OAuth client at https://once.deputy.com/my/oauth_clients to obtain a Client ID and Client Secret.","Direct the user through the OAuth 2.0 authorization code flow; exchange the authorization code for an access token and refresh token at the Deputy token endpoint.","Store the access token and use it as a Bearer token in the Authorization header for all subsequent requests to your install-specific base URL: https://{install}.{geo}.deputy.com/api/v1.","Query the Timesheet resource (GET /resource/Timesheet/QUERY) with a date-filter payload specifying start and end epoch timestamps to retrieve timesheet records.","Page through results—Deputy caps list responses at 500 records per page—using offset/limit parameters until all records are collected.","Use the refresh token to obtain a new access token before the current one expires; do not hard-code token lifetimes as they are returned in the token response."],"gotchas":["Each Deputy customer has a unique subdomain-based install URL (e.g., yourcompany.au.deputy.com); using the wrong base URL returns 404 errors rather than auth failures.","Permanent tokens are available as a simpler alternative to OAuth but are tied to a single user account and carry that user's permission scope—not suitable for multi-tenant integrations.","The Resource API uses POST for queries (not GET), with filter criteria in the request body; using GET for filtered queries returns unfiltered results."],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","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":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c50956c1-2dbd-4a9a-8bfa-57e43eed048f"}