Clear a user's external activity
POST/user.activity.clear
End an activity previously created with user.activity.set.
The row is keyed by this integration plus userId and externalId —
you cannot clear another app's activity.
Clearing a missing, already-cleared, or already-expired externalId
still returns 204. Integrations retry "session ended" webhooks, and
the row may have expired in the meantime.
See External activity for TTL, DND stacking, and what happens on the map when the last activity clears.
Access: Organization and Personal. Organization tokens may target any user in the workspace. Personal tokens (OAuth or PAT) may target only the token owner.
Required scope: user:write.activity. Personal Access Tokens skip
this check; personal-mode OAuth installs must still request the scope.
OpenAPI Spec: chat-v1.json
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 405
- 500
Activity cleared, or there was nothing to clear. No response body.
Bad request. Common causes:
- Missing
userIdorexternalId
Presented invalid authentication credentials.
Forbidden. Common causes:
- Missing
user:write.activity(OAuth / API key) - Personal token targeting a user other than the owner (
access_denied)
User not found, or not in this workspace (user_not_found).
An unsupported method was requested.
An internal error occurred.