action circuitsandbox_set_user_presence {
  label: "Updates the presence status"
  description: "Updates the presence status of the authenticated user.\nOauthScopes: WRITE_USER_PROFILE, MANAGE_PRESENCE"
  provider: circuitsandbox
  method: PUT
  path: "/users/presence"
  encoding: form
  output: {
    properties: {
      dndUntil: {
        type: "number"
        format: "int64"
        description: "Timestamp until the DND state of the user is active"
      }
      isOptedOut: {
        type: "boolean"
        description: "Indicates whether the user has opted out of their presence"
      }
      latitude: {
        type: "number"
        format: "float"
        description: "The latitude of the geo location of the user"
      }
      locationText: {
        type: "string"
        description: "The geo location of the user in clear text"
      }
      longitude: {
        type: "number"
        format: "float"
        description: "The longitude of the geo location of the user"
      }
      mobile: {
        type: "boolean"
        description: "Identifies whether the presence state is based on the state information of a mobile device or not"
      }
      poor: {
        type: "boolean"
        description: "n/a"
      }
      state: {
        type: "string"
        description: "The presence state of the user. It can be one of the following: AVAILABLE, OFFLINE, AWAY, BUSY, or DND (Do-Not-Disturb)"
      }
      statusMessage: {
        type: "string"
        description: "A free formed status message of the user"
      }
      timeZoneOffset: {
        type: "number"
        format: "int32"
        description: "The timezone offset of the user compared to UTC"
      }
      userId: {
        type: "string"
        description: "The ID of the user"
      }
    }
  }
}