> ## Documentation Index > Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-changelog-august-13.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get auth connection event timeline > Returns a chronological timeline of events for an auth connection — login attempts, automatic re-auth attempts, and health checks. Events are returned newest-first. ## OpenAPI ````yaml https://api.onkernel.com/spec.json get /auth/connections/{id}/timeline openapi: 3.1.0 info: description: Developer tools and cloud infrastructure for AI agents to use web browsers title: Kernel API version: 0.1.0 servers: - description: API Server url: https://api.onkernel.com security: - bearerAuth: [] tags: - description: Create and manage browser sessions. name: Browsers - description: Control mouse, keyboard, and screen on the browser instance. name: Browser Computer Controls - description: Execute Playwright code against the browser instance. name: Browser Playwright - description: Read, write, and manage files on the browser instance. name: Browser Filesystem - description: Execute and manage processes on the browser instance. name: Browser Processes - description: Record and manage browser session video replays. name: Browser Replays - description: Stream logs from the browser instance. name: Browser Logs - description: Stream live telemetry events from a browser session. name: Browser Telemetry - description: Create, list, retrieve, and delete browser profiles. name: Profiles - description: Create and manage proxy configurations for routing browser traffic. name: Proxies - description: Create, list, retrieve, and delete browser extensions. name: Extensions - description: Create and manage browser pools for acquiring and releasing browsers. name: Browser Pools - description: Inspect the identity and authorization context for the current request. name: Authentication - description: >- Create and manage auth connections for automated credential capture and login. name: Managed Auth - description: Create and manage credentials for authentication. name: Credentials - description: Configure external credential providers like 1Password. name: Credential Providers - description: List applications and versions. name: Apps - description: Create and manage app deployments and stream deployment events. name: Deployments - description: Invoke actions and stream or query invocation status and events. name: Invocations - description: Read and manage organization-level limits. name: Organization - description: | Create and manage projects for resource isolation within an organization. When projects are disabled for the organization, project operations return `404` with code `projects_disabled`. name: Projects - description: Create and manage API keys for organization and project-scoped access. name: API Keys - description: Read audit log records for the authenticated organization. name: Audit Logs - description: Resolve browser and proxy recommendations for bot-protected sites. name: Site Configs paths: /auth/connections/{id}/timeline: get: tags: - Managed Auth summary: Get auth connection event timeline description: | Returns a chronological timeline of events for an auth connection — login attempts, automatic re-auth attempts, and health checks. Events are returned newest-first. operationId: getAuthConnectionsTimelineById parameters: - description: Auth connection ID in: path name: id required: true schema: type: string - description: Filter the timeline to a single event type. in: query name: type required: false schema: enum: - login - reauth - health_check type: string - description: Maximum number of events to return in: query name: limit required: false schema: default: 20 maximum: 100 type: integer - description: Number of events to skip in: query name: offset required: false schema: default: 0 type: integer responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/ManagedAuthTimelineEvent' type: array description: Event timeline for the auth connection headers: X-Has-More: description: Whether there are more results schema: type: boolean X-Next-Offset: description: >- The offset where the next page starts. 0 when there are no more results. schema: type: integer '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' security: - bearerAuth: [] components: schemas: ManagedAuthTimelineEvent: description: >- A single event in an auth connection's history — a login attempt, an automatic re-auth attempt, or a health check. properties: browser_session_id: description: Browser session that produced the event, if one was created. type: string error_code: description: >- Machine-readable error code. Present when a login/reauth event failed. type: string error_message: description: >- Human-readable error message. Present when a login/reauth event failed. type: string id: description: Identifier of the underlying login/reauth session or health check. type: string previous_status: description: >- The session state observed before this event. Present for health_check events that recorded a prior state. enum: - AUTHENTICATED - NEEDS_AUTH type: string replay_id: description: >- Replay recording ID for the event's browser session, if session recording was enabled. type: string status: description: > Outcome of the event. For login/reauth events this is the flow status (IN_PROGRESS, SUCCESS, EXPIRED, CANCELED, FAILED). For health_check events it is the observed session state (AUTHENTICATED, NEEDS_AUTH). enum: - IN_PROGRESS - SUCCESS - EXPIRED - CANCELED - FAILED - AUTHENTICATED - NEEDS_AUTH type: string step: description: The step the flow reached. Present for login/reauth events. enum: - INITIALIZED - DISCOVERING - AWAITING_INPUT - AWAITING_EXTERNAL_ACTION - AWAITING_HUMAN_INTERVENTION - SUBMITTING - COMPLETED - EXPIRED type: string telemetry_captured: description: >- Whether browser telemetry capture started for this event's browser session. type: boolean timestamp: description: When the event occurred. format: date-time type: string type: description: >- The kind of event. "login" and "reauth" are authentication attempts; "health_check" is a periodic session-validity check. enum: - login - reauth - health_check type: string updated_at: description: When the event was last updated. Present for login/reauth events. format: date-time type: string website_error: description: >- Visible error message from the website (e.g., 'Incorrect password'). Present when the website displayed an error during the attempt. type: string required: - type - id - timestamp - status type: object Error: properties: code: description: Application-specific error code (machine-readable) example: bad_request type: string details: description: Additional error details (for multiple errors) items: $ref: '#/components/schemas/ErrorDetail' type: array inner_error: $ref: '#/components/schemas/ErrorDetail' message: description: Human-readable error description for debugging example: 'Missing required field: app_name' type: string required: - code - message type: object ErrorDetail: properties: code: description: Lower-level error code providing more specific detail example: invalid_input type: string message: description: Further detail about the error example: Provided version string is not semver compliant type: string type: object responses: Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Unauthorized – missing or invalid authorization token NotFound: content: application/json: schema: $ref: '#/components/schemas/Error' description: Resource not found InternalError: content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal Server Error securitySchemes: bearerAuth: scheme: bearer type: http ````