# Derive Artifacts API

**Canonical:** https://apis.io/apis/derive-to/derive-to-artifacts-api/  
**Provider:** Derive — https://apis.io/providers/derive-to/  
**Documentation:** https://docs.derive.to/reference/api/

Derive Artifacts API is one of 28 APIs that [Derive](https://apis.io/providers/derive-to/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Artifacts. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Documents (files and bundles): browse, publish, version, restore, and control access.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/artifacts` | List artifacts (keyset-paginated; ?sort=/query=/tag=/collection=/scope=/author=/… |
| GET | `/v1/tags` | Browse summary for the sidebar (totals + tag counts) |
| GET | `/v1/artifacts/{shortId}` | One artifact with its versions, sessions, roles, and counts |
| PATCH | `/v1/artifacts/{shortId}` | Rename an artifact (metadata only — no new version) |
| DELETE | `/v1/artifacts/{shortId}` | Permanently delete an artifact and all its dependents (owner only) |
| PATCH | `/v1/artifacts/{shortId}/access` | Change an artifact's access (workspace access, world link, listing) |
| PATCH | `/v1/artifacts/{shortId}/locked` | Lock or unlock an artifact (locked ⇒ nothing publishes until unlocked) |
| PUT | `/v1/artifacts/{shortId}/archive` | Archive an artifact (editors) |
| DELETE | `/v1/artifacts/{shortId}/archive` | Restore an archived artifact |
| POST | `/v1/bulk/archive` | Archive or restore many artifacts (editor-gated per artifact) |
| POST | `/v1/bulk/delete` | Permanently delete many artifacts (owner-only per artifact) |
| POST | `/v1/artifacts/{shortId}/move` | Move an artifact to another workspace you belong to (owner only) |
| POST | `/v1/artifacts/{shortId}/unlock` | Unlock a password-protected artifact (drops an unlock cookie) |
| POST | `/v1/artifacts/{shortId}/restore` | Restore a past version as a new revision (history is never rewritten) |
| POST | `/v1/artifacts/{shortId}/use` | Copy this artifact into your workspace (use it as a template) |
| POST | `/v1/preview` | Render a markdown or LaTeX draft to the exact published HTML (stateless… |
| POST | `/v1/artifacts/{shortId}/rework` | Ask a registered agent to rework this artifact to match the Brandprint |
| POST | `/v1/artifacts/{shortId}/generate-profile` | Ask a registered agent to build this workspace's brand profile |
| GET | `/v1/artifacts/{shortId}/save-as-skill` | The capture prompt: turn a review correction into a workspace skill |
| POST | `/v1/artifacts/{shortId}/save-as-skill` | Ask a registered agent to turn a review correction into a workspace skill |
| GET | `/v1/artifacts/{shortId}/fill` | The fill-with-your-work prompt for a derived copy (the copy-paste variant) |
| POST | `/v1/artifacts/{shortId}/fill` | Ask a registered agent to fill this derived copy with the workspace's real work |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/derive-to/openapi/derive-to-artifacts-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-artifact-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-context-analysis-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-agent-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-comment-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-collection-schema.json

## Other Derive APIs (12)

- [Derive Accounts API](https://apis.io/apis/derive-to/derive-to-accounts-api/)
- [Derive Activity API](https://apis.io/apis/derive-to/derive-to-activity-api/)
- [Derive Agents API](https://apis.io/apis/derive-to/derive-to-agents-api/)
- [Derive Analytics API](https://apis.io/apis/derive-to/derive-to-analytics-api/)
- [Derive Assets API](https://apis.io/apis/derive-to/derive-to-assets-api/)
- [Derive Collections API](https://apis.io/apis/derive-to/derive-to-collections-api/)
- [Derive Comments API](https://apis.io/apis/derive-to/derive-to-comments-api/)
- [Derive Contexts API](https://apis.io/apis/derive-to/derive-to-contexts-api/)
- [Derive Domains API](https://apis.io/apis/derive-to/derive-to-domains-api/)
- [Derive Exports API](https://apis.io/apis/derive-to/derive-to-exports-api/)
- [Derive Favorites API](https://apis.io/apis/derive-to/derive-to-favorites-api/)
- [Derive Folders API](https://apis.io/apis/derive-to/derive-to-folders-api/)

## Tags

Artifacts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/derive-to/derive-to-artifacts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/derive-to/.