---
title: "Generate a verified artifact"
method: POST
path: "/api/v1/tools/generate_artifact"
tags: ["Agent tools"]
---

# Generate a verified artifact

`POST /api/v1/tools/generate_artifact`

## Request

- Base URL: `https://parts.skoia.me`
- URL: `https://parts.skoia.me/api/v1/tools/generate_artifact`
- Auth: none declared

Generates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.

## Request body

- object
  - `solutionId` string, required
  - `format` 'STL' | '3MF' | 'OPENSCAD', required
  - `entitlement` 'FREE' | 'PAID_VERIFIED'

## Response `200`

Structured tool result

- object
  - `schemaVersion` unknown, required
  - `tool` string, required
  - `requestId` string, required
  - `status` 'OK' | 'NEEDS_INPUT' | 'BLOCKED' | 'UNAVAILABLE', required
  - `facts` object[], required
  - `confidence` object, required
    - `score` number, nullable, required
    - `level` 'HIGH' | 'MEDIUM' | 'LOW' | 'UNKNOWN', required
    - `reason` string, nullable
  - `provenance` object[], required
    - `type` string, required
    - `source` string, nullable
    - `retrieved_at` string, nullable
    - `verification_status` string, nullable
  - `warnings` string[], required
  - `data` object, required

## Other responses

- `4XX`: Machine-readable client error
- `5XX`: Machine-readable transient or provider error

---

[API](https://skmtc.dev/skoia/apis/skoia-parts-agent-api.md) · [All operations](https://skmtc.dev/skoia/apis/skoia-parts-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skoia/apis/skoia-parts-agent-api/revisions/cdad8c14db92?raw)