> ## Documentation Index > Fetch the complete documentation index at: https://docs.airscale.io/llms.txt > Use this file to discover all available pages before exploring further. # Mark a new hire event as read > Acknowledge one new hire after processing it. Rate limit: 120 requests per fixed minute per API key, shared by all new hire monitor endpoints. > [!NOTE] > > New hire monitoring requires a **V2 workspace API key**. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key. Mark one event as read after your integration has handled it. The response returns the event with its `read_at` timestamp, and the monitor's `unread_event_count` decreases. The request accepts an empty body or `{}`. A body that is present but not valid JSON returns `400`. > [!NOTE] > > The call is idempotent: marking an event that is already read returns it again with its first `read_at`. Webhook retries use the same event ID, so treat the event ID as the durable acknowledgement key. Reading an event does not delete it. You can still retrieve it through [List new hire events](https://docs.airscale.io/api-reference/new-hire-monitors/events.md). Marking events read spends no credits. ## Next step Review [Create a new hire monitor](https://docs.airscale.io/api-reference/new-hire-monitors/create.md) for webhook setup and signature verification. ## OpenAPI ````yaml openapi.json POST /v1/new-hire-monitors/{monitor_id}/events/{event_id}/read openapi: 3.1.0 info: title: Airscale Public API version: '2026-09-11' description: >- Search, enrich, resolve public business data, and monitor job changes with Airscale. x-airscale-source-repository: ViceScale/airscale-code x-airscale-source-sha: 1de19e1b70a052a4b8d9c2075021a7e5e7a94d51 servers: - url: https://api.airscale.io description: Production security: - bearerAuth: [] tags: - name: Search and discovery description: Search people, companies, and the web. - name: Contact data description: Find professional and personal contact data. - name: Profiles and reverse lookup description: Extract profiles or resolve a person from known contact data. - name: Post engagement description: Retrieve and enrich people who liked or commented on LinkedIn posts. - name: LinkedIn content description: >- Search LinkedIn posts, read profile and company feeds, and retrieve profile comments and comment reactions. - name: Job change monitoring description: Track LinkedIn profiles and receive job-change events. - name: New hire monitoring description: Watch companies or the market for people who start a matching role. - name: Post engagement monitoring description: >- Follow LinkedIn company pages and profiles and receive the people who engage with their posts. - name: Account description: Inspect workspace account state. - name: Miscellaneous description: >- Find website technologies and check WhatsApp availability, Meta ads, and email deliverability. paths: /v1/new-hire-monitors/{monitor_id}/events/{event_id}/read: post: tags: - New hire monitoring summary: Mark a new hire event as read description: >- Marks one event read and returns it with its read_at timestamp. The call is idempotent: an event that is already read keeps its first read time. The request body is optional: send no body or an empty JSON object. Requires a V2 workspace API key. Legacy V1 API keys are not supported. Monitors and their credits belong to the V2 workspace. operationId: markNewHireEventRead parameters: - name: monitor_id in: path required: true schema: type: string format: uuid example: 61111111-1111-4111-8111-111111111111 - name: event_id in: path required: true schema: type: string format: uuid example: 63333333-3333-4333-8333-333333333333 requestBody: required: false description: Optional. Send no body or an empty JSON object ({}). content: application/json: schema: type: object properties: {} additionalProperties: false examples: empty: summary: Acknowledge the event value: {} responses: '200': description: The event after it was marked read. content: application/json: schema: type: object additionalProperties: false required: - event properties: event: $ref: '#/components/schemas/NewHireEvent' examples: success: summary: Successful response value: event: id: 63333333-3333-4333-8333-333333333333 monitor_id: 61111111-1111-4111-8111-111111111111 detected_at: '2026-11-09T10:05:00.000Z' hire_type: external person: name: Example Person linkedin_url: https://www.linkedin.com/in/example-person location: Paris, France title: VP Sales start_date: 2026-10 company: name: Example Company linkedin_company_id: null linkedin_url: null previous_title: Director of Sales previous_company_name: Example Previous Company read_at: '2026-11-09T11:00:00.000Z' '400': description: The optional body is present but is not valid JSON. content: application/json: schema: $ref: '#/components/schemas/Error' examples: error: summary: Error response value: error: Invalid JSON '401': $ref: '#/components/responses/MonitorUnauthorized' '404': description: >- event_not_found: the event does not exist in this monitor or workspace. content: application/json: schema: $ref: '#/components/schemas/MonitorApiError' examples: error: summary: Error response value: error: code: monitor_not_found message: Monitor not found '429': description: >- The API key has exceeded 120 requests in the current minute across new hire monitor endpoints. Wait for the Retry-After seconds before retrying. content: application/json: schema: $ref: '#/components/schemas/Error' examples: error: summary: Error response value: error: Too Many Requests message: 'Rate limit exceeded: 120 requests per minute' headers: Retry-After: description: Seconds to wait before retrying. schema: type: string example: '60' '503': description: 'service_unavailable: new hire monitoring is temporarily unavailable.' content: application/json: schema: $ref: '#/components/schemas/MonitorApiError' components: schemas: NewHireEvent: type: object additionalProperties: false required: - id - monitor_id - detected_at - hire_type - person - title - start_date - company - previous_title - previous_company_name - read_at properties: id: type: string format: uuid monitor_id: type: string format: uuid detected_at: type: string format: date-time hire_type: type: - string - 'null' enum: - external - internal - null person: $ref: '#/components/schemas/NewHirePerson' title: type: - string - 'null' start_date: type: - string - 'null' pattern: ^\d{4}-\d{2}$ description: The reported start month (YYYY-MM), or null. company: $ref: '#/components/schemas/NewHireEventCompany' previous_title: type: - string - 'null' previous_company_name: type: - string - 'null' read_at: type: - string - 'null' format: date-time Error: type: object additionalProperties: true properties: error: type: string message: type: string MonitorApiError: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string NewHirePerson: type: object additionalProperties: false required: - name - linkedin_url - location properties: name: type: - string - 'null' linkedin_url: type: - string - 'null' location: type: - string - 'null' NewHireEventCompany: type: object additionalProperties: false required: - name - linkedin_company_id - linkedin_url properties: name: type: - string - 'null' linkedin_company_id: type: - string - 'null' linkedin_url: type: - string - 'null' description: >- https://www.linkedin.com/company/{linkedin_company_id}, or null when the ID is unknown. responses: MonitorUnauthorized: description: >- A missing Bearer token returns {"error":"Unauthorized","message":"Missing or invalid bearer token"}. An unknown API key returns invalid_api_key. content: application/json: schema: oneOf: - $ref: '#/components/schemas/MonitorApiError' - $ref: '#/components/schemas/Error' examples: invalidKey: summary: Unknown API key value: error: code: invalid_api_key message: The API key is not valid securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: >- Use an Airscale workspace API key. Never expose the key in client-side code. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.