> ## Documentation Index > Fetch the complete documentation index at: https://docs.arcmira.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Arcmira has three API capabilities: Search (entities, mentions, appearances, commercial intelligence), Monitors (trackers plus alert delivery), and Transcripts (read, generate, correct). Community Review is the cross-surface correction layer. > Discover pages at https://docs.arcmira.com/llms.txt, then fetch the matching page's .md export. Each capability has a self-contained ' for coding agents' page; prefer it. > Auth: Authorization: Bearer arc_sk_... or x-api-key: arc_sk_... (x-api-key wins if both are sent). Never put keys in browser code. Check GET /v1/me for tier, scopes, and remaining rows before metered pulls. > Search: resolve names with GET /v1/entities/lookup and pin ent_* IDs before pulling metered rows. Only person entities have appearances. Mention and recommendation rows carry canonical numeric timestamps in start_seconds/end_seconds (integer seconds; 0 means full episode); the MM:SS string fields are deprecated. Commercial routes need Pro+ tier AND the recommendations:read scope and bill 10 rows per row. > Monitors: a tracker watches one entity; a monitor groups trackers with shared delivery (email, Slack, HMAC-signed webhooks). Create trackers with POST /v1/trackers, then attach by id: POST /v1/monitors/{id}/trackers { trackerIds: [...] }. Each fired alert occurrence debits 100 rows. Poll GET /v1/monitors/{id}/alerts?n= for recent deliveries. Send Idempotency-Key on every POST/PATCH. > Transcripts: switch on the access field (unlocked, locked, premium_pending, not_transcribed, unauthenticated). Honor Retry-After when polling POST /v1/transcriptions jobs. Corrections (POST /v1/videos/{video_id}/corrections; kinds line_edit, speaker_reassign, speaker_identify, add_person, entity_tag, segment_rewrite) cost 0 rows; anchored kinds need revision + anchor.contentHash (djb2 base-36); handle 409 (re-anchor) and 412 (expectedSeq). segment_rewrite replaces an inclusive segment range with new segments (empty replacements array deletes; timestamps repaired server-side). > Community Review is free (0 rows) and surface-typed: POST /v1/feedback with a type matching the surface you called, the reproducing query, and corrections targeting public IDs (ent_*, men_*, com_*). Nothing auto-applies. Do not send untyped notes. > Errors: switch on error.code, follow doc_url, quote X-Request-Id to support. Honor Retry-After on 429. Retries of POST/PATCH must reuse the same Idempotency-Key; replays return Idempotency-Replayed: true. # List recent tracker alerts > The newest n alert deliveries for the tracker, as a single page. This endpoint does not paginate: has_more is always false and next_cursor is always null. entity_id ("ent_{n}") and mention_id ("men_{n}") are public-ID forms that join directly against entity and mention rows; media_id and appearance_id are raw integer ids, matching the numeric ids used elsewhere in the API. Dispute a fired alert via POST /v1/feedback with type monitor_alert. ## OpenAPI ````yaml /openapi/arcmira-v1.json get /v1/trackers/{id}/alerts openapi: 3.1.0 info: title: Arcmira API version: 1.0.0 contact: name: Arcmira url: https://arcmira.com servers: - url: https://api.arcmira.com security: [] paths: /v1/trackers/{id}/alerts: get: tags: - Trackers summary: List recent tracker alerts description: >- The newest n alert deliveries for the tracker, as a single page. This endpoint does not paginate: has_more is always false and next_cursor is always null. entity_id ("ent_{n}") and mention_id ("men_{n}") are public-ID forms that join directly against entity and mention rows; media_id and appearance_id are raw integer ids, matching the numeric ids used elsewhere in the API. Dispute a fired alert via POST /v1/feedback with type monitor_alert. operationId: list_tracker_alerts parameters: - schema: type: integer minimum: 1 maximum: 100 default: 25 required: false name: 'n' in: query responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AlertListResponse' '400': description: Invalid request content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '401': description: Authentication error content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '402': description: Quota exceeded content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '403': description: Permission error content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '404': description: Not found content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '409': description: Conflict content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '429': description: Rate limit exceeded content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error '500': description: Server error content: application/json: schema: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string param: type: string doc_url: type: string request_id: type: string required: - type - code - message - doc_url - request_id required: - error security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AlertListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/Alert' description: Newest alerts first. has_more: type: boolean description: >- CURRENTLY always false: this endpoint returns the newest n alerts as a single page and does not paginate. next_cursor: type: 'null' description: 'Always null: this endpoint does not paginate.' required: - data - has_more - next_cursor Alert: type: object properties: id: type: string description: Alert delivery id. tracker_id: type: - string - 'null' description: Id of the tracker (tracked entity) that produced the alert. monitor_id: type: - string - 'null' description: >- Id of the monitor the tracker belongs to. Null for trackers outside a monitor. entity_id: type: - string - 'null' description: >- Public id ("ent_{n}") of the entity that triggered the alert, when recorded. CURRENTLY always null: delivery rows do not yet store the entity id. Resolve the entity through mention_id or the embedded tracker instead. mention_id: type: - string - 'null' description: >- Public id ("men_{n}") of the mention/appearance row that triggered the alert. Joins directly against mention rows (e.g. /v1/mentions). Null when not appearance-scoped. media_id: type: - integer - 'null' description: >- Media row that triggered the alert. A raw integer database id, matching the numeric media ids used elsewhere in the API (e.g. mention media.id). Null when not media-scoped. appearance_id: type: - integer - 'null' description: >- Appearance row that triggered the alert. A raw integer database id, matching the numeric appearance_id on mention rows (same number as in mention_id). Null when not appearance-scoped. channel: type: string description: >- Delivery channel. Values: email (sent by email), webhook (POSTed to the configured webhook URL), slack (sent to Slack). status: type: string description: >- Delivery status. Values: pending (queued for delivery), sent (delivered), failed (delivery failed; see error_message), skipped (delivery intentionally skipped). final_status: type: - string - 'null' description: >- Terminal status after retries. Null while delivery is still in progress. error_message: type: - string - 'null' description: Error details for failed deliveries. Null unless delivery failed. scheduled_at: type: - string - 'null' description: When delivery was scheduled. Null when delivered immediately. sent_at: type: - string - 'null' description: When the alert was actually sent. Null until delivery succeeds. created_at: type: string description: When the alert row was created. tracker: type: object properties: id: type: - string - 'null' description: Tracker id. entity_name: type: - string - 'null' description: Tracked entity name. entity_type: type: - string - 'null' description: Tracked entity type. display_name: type: - string - 'null' description: >- User-facing display name for the tracker. Null when not customized. required: - id - entity_name - entity_type - display_name description: >- The tracker the alert belongs to. Fields are null when the tracker row was deleted. monitor: type: - object - 'null' properties: id: type: string description: Monitor id. name: type: - string - 'null' description: Monitor name. required: - id - name description: >- The monitor the tracker belongs to. Null for trackers outside a monitor. required: - id - tracker_id - monitor_id - entity_id - mention_id - media_id - appearance_id - channel - status - final_status - error_message - scheduled_at - sent_at - created_at - tracker - monitor securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: arc_sk_* apiKeyAuth: type: apiKey in: header name: x-api-key ````