Set a user's status bubble
POST/user.statusBubble.set
Replaces the shared UI/API thought bubble. Text is trimmed and limited to 1–20 Unicode code points. Omitted or null ttlSeconds defaults to 86400; integers from 300 through 86400 are accepted. Durations below 5 minutes or above 24 hours are rejected. Automatic map removal can take up to about a minute after expiration. Repeating set refreshes expiration. Sending expiresAt is rejected.
See Status bubbles.
Access: Organization and Personal. Organization credentials may target an active user in the workspace. Personal OAuth and PATs may target only their owner. The workspace comes from the token.
Required scope: user:write.statusBubble. PATs skip the scope check; personal OAuth requires the scope.
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 405
- 500
Current bubble and canonical user identifier.
Missing userId or text (missing_parameter), blank or overlong text or TTL outside 300–86400 (invalid_parameter), malformed JSON or wrong field types (invalid_json), or supplied expiresAt (invalid_arguments).
Invalid authentication credentials.
Missing scope or personal token targeting someone else.
Unknown, archived, or cross-account user.
Unsupported method.
Internal error.