makespdf-com Artifacts API
The artifacts API from makespdf-com — 1 operation(s) for artifacts.
The artifacts API from makespdf-com — 1 operation(s) for artifacts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/makespdf-com:makespdf-com-artifacts-api"
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.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: makesPDF Artifacts API
version: 1.0.0
description: 'Deterministic PDF rendering API: GitHub-flavoured Markdown or a compact DSL to tagged, PDF/A-2A + PDF/UA-1 dual-compliant PDFs. Authenticate with a Bearer token (API key or OAuth device flow), or pay per call via x402 (USDC on Base) on the x402-tagged operations. Errors use the shared Error schema. Rate limits are reported in RateLimit / RateLimit-Policy headers, with Retry-After on 429. Versioning: the major version is in the path (/api/v1); breaking changes ship as a new version, and a deprecated endpoint keeps working for at least 90 days after it starts sending Deprecation and Sunset headers.'
x-guidance: 'POST /api/v1/markdown converts markdown to PDF ($0.01). POST /api/v1/render renders a template from templateId or inline DSL ($0.02). Both require an x402 payment: call unpaid to receive the 402 challenge (PAYMENT-REQUIRED header), sign an EIP-3009 USDC transfer, retry with the PAYMENT-SIGNATURE header. Free: GET /api/v1/templates?owner=library lists curated templates.'
contact:
name: makesPDF support
email: jason@makespdf.com
url: https://makespdf.com/contact
servers:
- url: https://makespdf.com
security: []
tags:
- name: Artifacts
paths:
/api/v1/artifacts:
summary: List render artifacts
description: List the caller's recent render artifacts (metadata only).
get:
operationId: listArtifacts
summary: List artifacts
description: The caller's retained renders (7 days by default), newest first. Download one with GET /api/v1/artifacts/{id}/pdf.
tags:
- Artifacts
responses:
'200':
description: The caller's artifacts.
headers:
RateLimit:
$ref: '#/components/headers/RateLimit'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
content:
application/json:
schema:
$ref: '#/components/schemas/ArtifactList'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/ServerError'
security:
- bearerAuth: []
parameters:
- name: kind
in: query
schema:
type: string
enum:
- markdown
- canvas
- dsl-preview
- dsl-render
- alt-text-report
- tag-report
- name: templateId
in: query
schema:
type: string
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
default: 0
components:
schemas:
Artifact:
type: object
required:
- artifactId
- kind
- status
- createdAt
- expiresAt
- hasPdf
properties:
artifactId:
type: string
kind:
type: string
enum:
- markdown
- canvas
- dsl-preview
- dsl-render
- alt-text-report
- tag-report
origin:
type: string
enum:
- ui
- api
- cli
templateId:
type:
- string
- 'null'
templateName:
type:
- string
- 'null'
status:
type: string
enum:
- success
- error
pageCount:
type:
- integer
- 'null'
byteSize:
type:
- integer
- 'null'
creditsCharged:
type:
- integer
- 'null'
errorMessage:
type:
- string
- 'null'
createdAt:
type: string
format: date-time
expiresAt:
type: string
format: date-time
hasPdf:
type: boolean
Error:
type: object
required:
- error
description: Every 4xx/5xx JSON body. `error` is always present; the other fields appear when they apply.
properties:
error:
type: string
description: Human-readable message. Some routes use a stable kebab-case value (e.g. `rate-limited`, `in-place-impossible`) that is safe to branch on.
code:
type: string
description: Machine-readable error code, when the route sets one (e.g. `containers-disabled`).
details:
type: array
items:
type: string
description: 'Per-field validation messages, `path: message`.'
issues:
type: array
items:
$ref: '#/components/schemas/ValidationIssue'
description: Template validation issues, on DSL/catalog failures.
hint:
type: string
description: How to fix the request.
retryAfter:
type: integer
description: Seconds until the rate limit resets (429 only; mirrors Retry-After).
docs:
type: string
format: uri
agent_guide:
type: string
format: uri
skill:
type: string
format: uri
additionalProperties: true
ArtifactList:
type: object
required:
- items
- total
- limit
- offset
properties:
items:
type: array
items:
$ref: '#/components/schemas/Artifact'
total:
type: integer
limit:
type: integer
offset:
type: integer
ValidationIssue:
type: object
required:
- severity
- message
properties:
severity:
type: string
enum:
- error
- warning
message:
type: string
path:
type: string
description: Location in the document tree.
rule:
type: string
description: Rule identifier, e.g. a PDF/UA check.
headers:
RateLimit:
description: Quota left in each policy this request counted against (draft-ietf-httpapi-ratelimit-headers-11), e.g. `"render";r=1999;t=3600`. `r` = requests remaining, `t` = seconds until the oldest counted request leaves the window.
schema:
type: string
RateLimit-Policy:
description: Policies this request counted against, e.g. `"render";q=2000;w=3600`. `q` = quota, `w` = window in seconds.
schema:
type: string
Retry-After:
description: Seconds to wait before retrying. Takes precedence over RateLimit.
schema:
type: integer
minimum: 0
responses:
Unauthorized:
description: Missing or invalid Bearer token. The body links the docs, llms.txt and the auth skill.
headers:
RateLimit:
$ref: '#/components/headers/RateLimit'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ServerError:
description: Unexpected server error. Never billed.
headers:
RateLimit:
$ref: '#/components/headers/RateLimit'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
TooManyRequests:
description: Rate limit exceeded.
headers:
RateLimit:
$ref: '#/components/headers/RateLimit'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
Retry-After:
$ref: '#/components/headers/Retry-After'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
BadRequest:
description: Malformed body or failed validation. Never billed.
headers:
RateLimit:
$ref: '#/components/headers/RateLimit'
RateLimit-Policy:
$ref: '#/components/headers/RateLimit-Policy'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key or OAuth device-flow token sent as `Authorization: Bearer <token>`. Agents should get one through the device flow (/skills/pdf-auth.md); never ask a user for their password.'
externalDocs:
description: API reference, including errors, rate limits and the versioning policy
url: https://makespdf.com/docs/api
x-discovery:
ownershipProofs:
- '0xF4d2bC1034beE5eA270AcA773aEB97736d14fb31'