{"id":"569177b9-416c-4dcf-b267-6fca2e16a901","task":"Update a Genesys Cloud user's presence status via the Users Presence API","domain":"developer.genesys.cloud","steps":["Obtain an OAuth2 token via the client credentials grant: POST /oauth/token on the region's login host (e.g. login.mypurecloud.com) with a Basic auth header (base64 client_id:client_secret) and grant_type=client_credentials, then use the returned bearer token on subsequent calls.","Call GET /api/v2/presencedefinitions (paginated with pageNumber/pageSize) to list organization presence definitions and find the target definition's id by matching its systemPresence value (e.g. \"Available\", \"Break\") among entries flagged as primary.","Read a user's current presence with a GET on the user (expand=presence) to see the active presenceDefinition and source.","PATCH /api/v2/users/{userId}/presences/purecloud (or /presences/{sourceId} for a non-PureCloud source) with a body containing presenceDefinition: { id } to change the user's presence to the desired system or custom status.","To change another user's presence rather than your own, ensure the calling OAuth client/user has been granted the presence:userPresence:edit permission."],"gotchas":["As of July 20, 2025, Genesys Cloud enforces the presence:userPresence:edit permission for PATCHing another user's presence; previously this worked without any permission check via an undocumented path, so older integrations may start failing 403 until the permission is added.","The /api/v2/presencedefinitions endpoint is non-division-aware and is being deprecated in favor of /api/v2/presence/definitions; presence definitions scoped to a specific division are not returned by the legacy endpoint.","Client-credentials tokens are not tied to a user context, so endpoints like /api/v2/users/me are unavailable — you must already know or look up the target userId."],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","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":"verified","url":"https://mcp.waymark.network/r/569177b9-416c-4dcf-b267-6fca2e16a901"}