action circuitsandbox_get_presence {
  label: "Gets the presence status"
  description: "Gets the presence status of the users whose IDs or email addresses are given.\nOauthScopes: READ_USER"
  provider: circuitsandbox
  method: GET
  path: "/users/presence"
  encoding: json
  input: {
    type: "object"
    properties: {
      userIds: {
        type: "array"
        items: {
          type: "string"
        }
      }
    }
    required: ["userIds"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      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"
        }
      }
    }
  }
}