Contents

Save user status

Save and get the user status.

Method

POST

URL

https://typetalk.com/api/v1/spaces/:spaceKey/userStatuses

Scope

my

URL parameters

NameTypeDescription
spaceKeyStringSpace key

Form parameters

NameTypeDescription
emojiStringEmoji syntax
message (Optional)StringStatus message
clearAt (Optional)StringDate time when status will be cleared at
isNotificationDisabled (Optional)BooleanDisable notification default value: false

Response Example

{
    "userStatus": {
        "id": 123,
        "accountId": 2500,
        "spaceId": 34,
        "emoji": ":spiral_note_pad:",
        "message": "Meeting",
        "clearAt": "2019-09-06T10:49:00Z",
        "isNotificationDisabled": true,
        "createdAt": "2019-09-02T06:28:02Z",
        "updatedAt": "2019-09-06T10:19:43Z"
    }
}

All responses are formatted in JSON and include an ETag. If you call an API with an If-None-Match header, the server will return a 304 status code if the data is unchanged. The date and time format is ISO 8601, and the timezone is UTC (eg. 2014-01-09T06:20:08Z).