Skip to main content
For organizations with strict security or compliance requirements, Hireflix provides audit logs. These logs record what actions were performed, when they occurred, and from which IP address or client (Admin UI, API, or Shareable Link). Logs are retained for the last 2 months.
If you need long-term history, periodically fetch and store them in your own system.

GraphQL Request

query getBasicInfo {
  info {
    company {
      logs {
        audit(pagination: { skip: 0, limit: 10 }) {
          count
          total
          results {
            actor {
              id
              email
            }
            timestamp
            object
            ip
            action
            host
            referer
            medium
          }
        }
      }
    }
  }
}

Explanation

  • info.company.logs.audit — retrieves audit events for your company account.
  • pagination.skip**/ ** limit — basic pagination.
    • Example: skip: 0, limit: 10 fetches the first 10 records.
    • Increase skip by 10 on subsequent calls to paginate.
  • actor — user or system performing the action (email and user ID).
  • timestamp — when the event occurred (in milliseconds since epoch).
  • action — describes the type of operation (e.g., interview.delete, position.create).
  • object — the resource impacted by the action (e.g., an Interview, Position, or User).
  • medium — where the action came from: ADMIN, API_KEY, or WEBAPP_INTERVIEW_SHAREABLE_LINK.
  • referer**/ ** host — origin URLs for context (useful for debugging API vs Admin actions).

Example Response

{
  "data": {
    "info": {
      "company": {
        "logs": {
          "audit": {
            "count": 10,
            "total": 42,
            "results": [
              {
                "timestamp": 1760271725833,
                "ip": "109.142.71.80",
                "action": "interview.delete",
                "host": "api.hireflix.com",
                "referer": "https://studio.apollographql.com/sandbox/explorer",
                "medium": "API_KEY",
                "actor": {
                  "id": "68b43b275e65a4c6a828a083",
                  "email": "michielmulders1@gmail.com"
                },
                "object": {
                  "id": "68b5d483c8f8862e71ace029",
                  "type": "INTERVIEW"
                }
              },
              {
                "timestamp": 1760200242843,
                "ip": "109.128.98.117",
                "action": "user.login-with-company",
                "host": "admin.hireflix.com",
                "referer": "https://admin.hireflix.com/en/login",
                "medium": "ADMIN",
                "actor": {
                  "id": "68b43b275e65a4c6a828a083",
                  "email": "michielmulders1@gmail.com"
                },
                "object": {
                  "id": "68b43b275e65a4c6a828a083",
                  "type": "USER",
                  "name": "Michiel",
                  "email": "michielmulders1@gmail.com"
                }
              },
              {
                "timestamp": 1760199631103,
                "ip": "109.128.98.117",
                "action": "interview.score-interview",
                "host": "api.hireflix.com",
                "referer": "https://studio.apollographql.com/sandbox/explorer",
                "medium": "API_KEY",
                "actor": {
                  "id": "68b43b275e65a4c6a828a083",
                  "email": "michielmulders1@gmail.com"
                },
                "object": {
                  "id": "68d4164f19367e041b2030c0",
                  "type": "INTERVIEW",
                  "urls": {
                    "private": "https://admin.hireflix.com/jobs/68b43e38b19cf131a17c543f/interview/68d4164f19367e041b2030c0"
                  },
                  "email": "documentationstrategy@gmail.com"
                }
              }
            ]
          }
        }
      }
    }
  }
}

Usage Tips

  • Pagination: Use the count and total fields to determine how many additional pages of logs exist.
  • Automation: Run this query periodically (e.g., nightly) to capture and archive all logs for long-term auditability.
  • Filtering: You can easily post-process logs by action, medium, or actor.email to analyze API vs admin activity.
  • Compliance: Audit logs are particularly helpful for GDPR data access requests or internal compliance reviews.