action circuitsandbox_get_user_presence {
  label: "Gets the presence status"
  description: "Gets the presence status of the users whose ID or email address is given.\nOauthScopes: READ_USER"
  provider: circuitsandbox
  method: GET
  path: "/users/{id}/presence"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "string"
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  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"
      }
    }
  }
}