Derive

Derive Artifacts API

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

GitHub OpenAPI

Operations 22

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 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/derive-to/openapi/derive-to-artifacts-api-openapi.yml

Schemas & Data

📊
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/derive-to:derive-to-artifacts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

derive-to-artifacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Derive Artifacts API
  version: 1.0.0
  description: 'Derive''s HTTP API. Every response shape here is the single source of truth for the web client — generated from the same Zod schemas that back this reference, so the docs never drift from the running API.


    **Auth:** a session cookie (browser) or a bearer token (agents and the CLI). Most write routes are scoped to the caller''s active workspace. The `/v1` paths are the stable product surface; `/openapi.json` serves this spec and `/docs` renders it.'
tags:


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://artifacts.apis.io/derive-to/openapi/derive-to-artifacts-api-openapi.yml