action sendgrid_get_access_settings_activity {
  label: "Retrieve all recent access attempts"
  description: "**This endpoint allows you to retrieve a list of all of the IP addresses that recently attempted to access your account either through the User Interface or the API.**"
  provider: sendgrid
  method: GET
  path: "/access_settings/activity"
  encoding: json
  input: {
    type: "object"
    properties: {
      limit: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["result"]
    properties: {
      result: {
        type: "array"
        description: "An array containing the IPs that recently attempted to access your account."
        items: {
          type: "object"
          required: ["allowed", "auth_method", "first_at", "ip", "last_at", "location"]
          properties: {
            allowed: {
              type: "boolean"
              description: "Indicates if the IP address was granted access to the account."
            }
            auth_method: {
              type: "string"
              description: "The authentication method used when attempting access."
            }
            first_at: {
              type: "integer"
              description: "A Unix timestamp indicating when the first access attempt was made."
            }
            ip: {
              type: "string"
              description: "The IP addressed used during the access attempt."
            }
            last_at: {
              type: "integer"
              description: "A Unix timestamp indicating when the most recent access attempt was made"
            }
            location: {
              type: "string"
              description: "The geographic location from which the access attempt originated."
            }
          }
        }
      }
    }
  }
}