> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Track an App interaction event > Record a user interaction event for a public App — no authentication required. Interaction events are written to the ``app_interactions`` collection for analytics and relevance tuning. Write errors are swallowed server-side so that a transient storage failure never surfaces as an error to the caller. **Example:** ```json { "event_type": "click", "document_id": "doc_abc123", "position": 2, "query": "red sneakers", "session_id": "sess_xyz" } ``` ## OpenAPI ````yaml post /v1/public/apps/{slug}/interactions openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: [] paths: /v1/public/apps/{slug}/interactions: post: tags: - Public Apps API summary: Track an App interaction event description: >- Record a user interaction event for a public App — no authentication required. Interaction events are written to the ``app_interactions`` collection for analytics and relevance tuning. Write errors are swallowed server-side so that a transient storage failure never surfaces as an error to the caller. **Example:** ```json { "event_type": "click", "document_id": "doc_abc123", "position": 2, "query": "red sneakers", "session_id": "sess_xyz" } ``` operationId: track_public_app_interaction_v1_public_apps__slug__interactions_post parameters: - name: slug in: path required: true schema: type: string description: Globally unique app slug title: Slug description: Globally unique app slug requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InteractionRequest' responses: '200': description: Acknowledgement that the event was recorded content: application/json: schema: type: object additionalProperties: true title: >- Response Track Public App Interaction V1 Public Apps Slug Interactions Post '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: InteractionRequest: properties: event_type: type: string title: Event Type description: Interaction event type (e.g. 'click', 'search') document_id: anyOf: - type: string - type: 'null' title: Document Id description: ID of the document interacted with position: anyOf: - type: integer - type: 'null' title: Position description: Zero-based position of the result query: anyOf: - type: string - type: 'null' title: Query description: Search query that produced the result result_count: anyOf: - type: integer - type: 'null' title: Result Count description: Number of results returned latency_ms: anyOf: - type: integer - type: 'null' title: Latency Ms description: Time from request to first result (ms) dwell_ms: anyOf: - type: integer - type: 'null' title: Dwell Ms description: Time the user spent on the result (ms) session_id: anyOf: - type: string - type: 'null' title: Session Id description: Client-side session identifier metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Arbitrary extra metadata additionalProperties: true type: object required: - event_type title: InteractionRequest description: |- Request body for tracking a user interaction with a public App. Extra top-level fields are stored as-is alongside the standard fields, allowing callers to attach arbitrary metadata without schema changes. ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ````