> ## Documentation Index > Fetch the complete documentation index at: https://docs.zespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Dismiss a model deprecation finding > Suppresses a finding at its current urgency band. It reopens automatically — exactly once, and notifies again — the next time the daily scan finds the band has tightened (90 → 30 → 7 days, or into retired). A band that widens, which only happens when a feed correction pushes the retirement date further out, never reopens a dismissal. **Authenticated with a dashboard session (browser cookie), not `x-api-key`**, and requires the `alerts:manage` permission — dismissing a finding is the same shape of decision as editing an alert rule. ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/projects/{id}/model-lifecycle/{findingId}/dismiss openapi: 3.1.0 info: title: Zespan Public API version: 1.0.0 description: > The Zespan Public API covers the endpoints that customers call directly or through the Zespan SDKs: trace ingestion (native and OpenTelemetry), prompt management, datasets and dataset runs, and the runtime guardrails check. All endpoints authenticate with a project API key sent in the `x-api-key` header. Create and manage API keys from the project settings in the Zespan dashboard. servers: - url: https://api.zespan.com description: Zespan production API security: - ApiKeyAuth: [] tags: - name: Ingestion description: Send traces and events to Zespan. - name: OpenTelemetry description: OTLP-compatible ingestion endpoints. - name: Prompts description: Manage versioned prompts and their labels, tags, and folders. - name: Datasets description: Read datasets and manage dataset runs used for experiments and scoring. - name: Guardrails description: Runtime guardrail evaluation. - name: SDK / CLI support description: > Small support endpoints consumed by the SDKs and @zespan/cli rather than called directly by application code. - name: Blast Radius description: > The prompt/agent/model/policy/evaluator/alert dependency graph backing the pre-release impact check and the evaluator-delete gate in the dashboard. Session-authenticated (dashboard cookie), not `x-api-key`. - name: Outcomes description: > Report business outcomes (a deflected ticket, an avoided refund, an SLA met) attributed to a trace, and read them back summarized by agent or model, joined to real trace cost. Backs the Value dashboard page. The ingest endpoint is `x-api-key`-authenticated like the rest of ingestion; the two read endpoints are session-authenticated (dashboard cookie) like Blast Radius. - name: Compliance description: > Generate audit-ready evidence documents (a per-agent Compliance Card, or SOC 2 control evidence) from recorded platform data, and re-verify a generated document's citations against live data. Session-authenticated (dashboard cookie), not `x-api-key`, gated by `compliance:read` / `compliance:generate` permissions and the Pro plan or above (the framework listing is the one exception — no project scope and no plan gate, since a customer deciding whether to upgrade needs to see what they'd get). - name: Models description: > Per-model usage, cost, latency, and error-rate rollups for a project, including the lifecycle overlay described under the Model Lifecycle tag. Session-authenticated (dashboard cookie), not `x-api-key`, gated by `dashboard:read`. - name: Model Lifecycle description: > Findings from the daily model deprecation scan, which matches models a project actually calls against a curated, bundled catalogue of provider-announced deprecation and retirement dates. Every figure on a finding (call volume, cost, affected agents/prompts, cost comparison against a named successor) is measured from real trace data — there is no quality-delta or regression-comparison endpoint, because nothing in this API invokes a model on the caller's behalf. Session-authenticated (dashboard cookie), not `x-api-key`: reading findings and the catalogue requires `dashboard:read`, dismissing a finding requires `alerts:manage`. paths: /v1/projects/{id}/model-lifecycle/{findingId}/dismiss: post: tags: - Model Lifecycle summary: Dismiss a model deprecation finding description: > Suppresses a finding at its current urgency band. It reopens automatically — exactly once, and notifies again — the next time the daily scan finds the band has tightened (90 → 30 → 7 days, or into retired). A band that widens, which only happens when a feed correction pushes the retirement date further out, never reopens a dismissal. **Authenticated with a dashboard session (browser cookie), not `x-api-key`**, and requires the `alerts:manage` permission — dismissing a finding is the same shape of decision as editing an alert rule. operationId: dismissModelLifecycleFinding parameters: - name: id in: path required: true schema: type: string format: uuid description: Project id. - name: findingId in: path required: true schema: type: string description: The finding's id. requestBody: required: true content: application/json: schema: type: object properties: reason: type: string minLength: 1 maxLength: 500 description: > Required. A dismissal with no stated reason is exactly what a later reviewer needs and can't reconstruct. required: - reason responses: '200': description: The updated, now-dismissed finding. content: application/json: schema: type: object properties: finding: $ref: '#/components/schemas/ModelLifecycleFinding' required: - finding '403': description: >- Not authenticated with a dashboard session, or lacks `alerts:manage`. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No finding with this id in this project. content: application/json: schema: $ref: '#/components/schemas/Error' security: [] components: schemas: ModelLifecycleFinding: type: object description: > One (project, model) deprecation finding. `callVolume30d`, `cost30dUsd`, `successorCallVolume30d`, and `costDeltaPerCallUsd` are all measured from real ClickHouse trace data over the trailing 30 days — never estimated, and never a quality or regression figure. properties: id: type: string projectId: type: string format: uuid environmentId: type: string nullable: true environmentSlugs: type: array items: type: string model: type: string provider: type: string nullable: true kind: type: string enum: - deprecation description: Reserved for a future `drift` kind — not written by anything today. deprecatedAt: type: string format: date-time nullable: true retiresAt: type: string format: date-time nullable: true daysRemaining: type: integer nullable: true description: Negative when the model has already retired. band: type: integer nullable: true enum: - 90 - 30 - 7 - 0 retired: type: boolean callVolume30d: type: integer description: Real call count over the trailing 30 days. cost30dUsd: type: number description: Real spend in USD over the trailing 30 days. affectedAgents: type: array items: type: string affectedPrompts: type: array items: type: string description: >- `"name@vN"` — the prompt name and version, e.g. `"refund-policy@v4"`. successorModel: type: string nullable: true successorCallVolume30d: type: integer nullable: true costDeltaPerCallUsd: type: number nullable: true description: > Average cost per call on `successorModel` minus this model, over your own organic traffic on both over the same 30 days. `null` when `comparisonBasis` is `none`. comparisonBasis: type: string enum: - organic_traffic - none description: >- `none` means there is no traffic on the successor to compare against yet — not that the comparison failed. lifecycleSource: type: string nullable: true enum: - announced - inferred - manual lifecycleCheckedAt: type: string format: date-time nullable: true status: type: string enum: - open - dismissed dismissedReason: type: string nullable: true dismissedAt: type: string format: date-time nullable: true detectedAt: type: string format: date-time required: - id - projectId - environmentId - environmentSlugs - model - provider - kind - deprecatedAt - retiresAt - daysRemaining - band - retired - callVolume30d - cost30dUsd - affectedAgents - affectedPrompts - successorModel - successorCallVolume30d - costDeltaPerCallUsd - comparisonBasis - lifecycleSource - lifecycleCheckedAt - status - dismissedReason - dismissedAt - detectedAt Error: type: object properties: error: type: string description: Human-readable error message. example: Unauthorized code: type: string description: Machine-readable error code, when present. example: rate_limit_exceeded required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Project API key. Manage keys in the Zespan dashboard under project settings. ````