> ## Documentation Index
> Fetch the complete documentation index at: https://help.nops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get artifact

> Get one artifact, including its raw file text in `content` (null if it could not be read). Requires `artifacts:read`.



## OpenAPI

````yaml /openapi.json get /v1/artifacts/{id}
openapi: 3.1.0
info:
  title: nOps Public API
  version: 1.0.0
  description: >-
    Programmatic access to nOps cost, budgets, cost allocation, Explorer
    dashboards, AI optimization, MAP manager, business unit economics, contract
    tracker, seat tracking, reports, recommendations, feed, scheduled prompts,
    notifications, and the nOps Artifacts catalog. Authenticate with an API key
    (Bearer token). Available on Inform + Operate.
servers:
  - url: https://api.nops.io
    description: Production
security:
  - bearerApiKey: []
tags:
  - name: Recommendations
    description: Cost optimization recommendations.
  - name: Anomalies
    description: AWS cost anomaly detection.
  - name: Explorer
    description: Cost Explorer queries — summary, history, heatmap, and dimensions.
  - name: Budgets
    description: Budgets, planning grids, alerts, and exports.
  - name: Seat Tracking
    description: >-
      AI seat tracking projects — per-user spend, limits, provider
      configuration, limit requests, automation, and analytics.
  - name: Reports
    description: Saved reports — create, update, render, and send.
  - name: Feed
    description: Clara Feed runs and delivery history.
  - name: Scheduled prompts
    description: Scheduled Clara prompts and manual runs.
  - name: Notifications
    description: Schedule and manage notification deliveries.
  - name: Commitments
    description: Commitment inventory (reserved for future use).
  - name: Cost allocation
    description: Cost Allocation showbacks, rules, and spend analytics.
  - name: Explorer dashboards
    description: Explorer dashboard layouts and widgets.
  - name: AI optimization
    description: AI Optimization default dashboard and anomaly insights.
  - name: MAP Manager
    description: AWS Migration Acceleration Program (MAP) project tracking.
  - name: Business unit economics
    description: Business unit economics models, units, and portfolio summaries.
  - name: Contract tracker
    description: Enterprise contract tracking and burndown analytics.
  - name: Artifacts
    description: >-
      nOps-curated Skills and Artifacts (HTML and Markdown files): list,
      details, file download, and preview image. Read-only.
paths:
  /v1/artifacts/{id}:
    get:
      tags:
        - Artifacts
      summary: Get artifact
      description: >-
        Get one artifact, including its raw file text in `content` (null if it
        could not be read). Requires `artifacts:read`.
      operationId: getArtifact
      parameters:
        - schema:
            type: string
            description: Artifact ID
          required: true
          name: id
          in: path
      responses:
        '200':
          description: Get artifact
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: JSON object
                    additionalProperties: true
                required:
                  - data
              example:
                data:
                  id: 7b9f0c1e-3a52-4d7e-9c41-2f8e6a1d5b30
                  title: Commitment Analysis
                  description: >-
                    Clara skill for reviewing RI and Savings Plan coverage and
                    burndown.
                  kind: skill
                  fileFormat: md
                  fileName: commitment-analysis.md
                  fileSizeBytes: 4821
                  imageUrl: /v1/artifacts/7b9f0c1e-3a52-4d7e-9c41-2f8e6a1d5b30/image
                  downloadUrl: /v1/artifacts/7b9f0c1e-3a52-4d7e-9c41-2f8e6a1d5b30/download
                  createdAt: '2026-07-17T12:00:00.000Z'
                  updatedAt: '2026-07-17T12:00:00.000Z'
                  createdByName: nOps Team
                  updatedByName: nOps Team
                  content: |
                    # Commitment Analysis

                    Use this skill to review RI and Savings Plan coverage.
        '401':
          description: Unauthorized — invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              example:
                error:
                  code: forbidden_scope
                  message: 'API key is missing required scope: budgets:write'
                  request_id: 550e8400-e29b-41d4-a716-446655440000
        '403':
          description: Forbidden — insufficient permissions or entitlement
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
              example:
                error:
                  code: forbidden_scope
                  message: 'API key is missing required scope: budgets:write'
                  request_id: 550e8400-e29b-41d4-a716-446655440000
      security:
        - bearerApiKey: []
components:
  schemas:
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
          required:
            - code
            - message
            - request_id
      required:
        - error
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      description: >-
        API key from Settings → Security → API Keys. Pass as `Authorization:
        Bearer YOUR_API_KEY`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.