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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/pageweave-dev:pageweave-dev-assets-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: PageWeave Assets API
version: 1.0.0
summary: Programmatic control plane for PageWeave websites.
description: 'Version 1 of the PageWeave HTTP API. Every endpoint under `/api/v1`
authenticates with a bearer API key unless its operation declares an
anonymous alternative — `security: []` or an optional requirement such as
`[{bearerAuth: []}, {}]` for upload sessions.
Errors use RFC 9457 Problem Details (`application/problem+json`). Rate
limits follow draft-ietf-httpapi-ratelimit-headers-11 and are reported on
every authenticated response through the `RateLimit-Policy` and
`RateLimit` headers.
The contract is additive within v1: operations and response fields may be
added, never removed or changed incompatibly.'
contact:
name: PageWeave
url: https://pageweave.dev/docs/api
externalDocs:
description: Guide, authentication, pagination, errors, and worked examples.
url: https://pageweave.dev/docs/api/guide
servers:
- url: https://pageweave.dev
description: Production
tags:
- name: Assets
description: Uploaded files served from `/assets`.
paths:
/api/v1/websites/{website_id}/assets:
parameters:
- name: website_id
in: path
required: true
description: Website UUID or subdomain.
schema:
type: string
get:
operationId: listAssets
summary: List assets
description: 'Keyset-paginated asset list. `content_type` accepts a category alias
(`image`, `font`, `document`, `audio`, `video`, `text`) or a MIME
type prefix; `filename` is a case-insensitive substring.'
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.read
x-required-scope: website
x-required-credential: read
parameters:
- $ref: '#/components/parameters/Cursor'
- $ref: '#/components/parameters/Limit'
- name: content_type
in: query
required: false
description: MIME category alias (`image`, `font`, `document`, `audio`, `video`, `text`) or a raw type prefix.
schema:
type: string
- name: filename
in: query
required: false
description: Case-insensitive filename substring.
schema:
type: string
responses:
'200':
description: A page of assets
content:
application/json:
schema:
$ref: '#/components/schemas/AssetsCollection'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
post:
operationId: createAsset
summary: Upload an asset
description: 'Uploads a file directly. Accepts a `multipart/form-data` body with a
`file` part, or a raw body with `?filename=` and a `Content-Type`.
The type must be on the asset allowlist and the size within the
per-type ceiling. Large binaries should use an upload session instead.
The response carries the asset and the website''s current storage
usage. Direct uploads are not idempotency-wrapped (multipart bodies
are not stored).'
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.create
x-required-scope: website
x-required-credential: write
parameters:
- $ref: '#/components/parameters/UploadFilename'
requestBody:
required: false
description: 'The file bytes. Multipart uses the `file` part''s own filename and
content type; a raw body uses `?filename=` and the request''s
`Content-Type`.
'
content:
multipart/form-data:
schema:
type: object
required:
- file
properties:
file:
type: string
format: binary
'*/*':
schema:
type: string
format: binary
responses:
'201':
$ref: '#/components/responses/AssetCreated'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'413':
$ref: '#/components/responses/ContentTooLarge'
'422':
$ref: '#/components/responses/Unprocessable'
'429':
$ref: '#/components/responses/TooManyRequests'
'503':
$ref: '#/components/responses/ServiceUnavailable'
/api/v1/websites/{website_id}/assets/{id}:
parameters:
- name: website_id
in: path
required: true
description: Website UUID or subdomain.
schema:
type: string
- name: id
in: path
required: true
description: Asset UUID.
schema:
type: string
format: uuid
get:
operationId: getAsset
summary: Get an asset
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.read
x-required-scope: website
x-required-credential: read
responses:
'200':
description: The asset
headers:
ETag:
description: Strong validator over the representation.
schema:
type: string
Last-Modified:
description: The asset's last update.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Asset'
'304':
$ref: '#/components/responses/NotModified'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
delete:
operationId: deleteAsset
summary: Delete an asset
description: 'Deletes the asset permanently: the row, its file, and every variant.
Pages that still reference `/assets/{id}/...` will 404 the asset.
There is no restore and no discard bin for assets.'
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.delete
x-required-scope: website
x-required-credential: write
responses:
'204':
description: The asset was deleted
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
/api/v1/websites/{website_id}/assets/{asset_id}/content:
parameters:
- name: website_id
in: path
required: true
description: Website UUID or subdomain.
schema:
type: string
- name: asset_id
in: path
required: true
description: Asset UUID.
schema:
type: string
format: uuid
put:
operationId: replaceAssetContent
summary: Replace an asset's bytes
description: 'Replaces the bytes behind an existing asset. The asset id, filename,
and `relative_url` path survive; the `?v=` cache-bust token flips, and
every page serving the asset serves the new bytes. The new content
type must match the original.'
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.create
x-required-scope: website
x-required-credential: write
requestBody:
required: false
description: 'The replacement bytes, as a multipart `file` part or a raw body.
'
content:
multipart/form-data:
schema:
type: object
required:
- file
properties:
file:
type: string
format: binary
'*/*':
schema:
type: string
format: binary
responses:
'200':
$ref: '#/components/responses/AssetReplaced'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'413':
$ref: '#/components/responses/ContentTooLarge'
'422':
$ref: '#/components/responses/Unprocessable'
'429':
$ref: '#/components/responses/TooManyRequests'
'503':
$ref: '#/components/responses/ServiceUnavailable'
/api/v1/websites/{website_id}/asset_imports:
parameters:
- name: website_id
in: path
required: true
description: Website UUID or subdomain.
schema:
type: string
post:
operationId: createAssetImport
summary: Import an asset from a URL or base64
description: 'Fetches bytes from a remote URL or decodes a base64 payload and stores
them as an asset. Provide exactly one of `url` or `base64`. Base64
requires `filename` and `content_type` and is capped at 20 KB after
decoding. Private-network URLs are rejected.
Passing `asset_id` replaces that asset''s bytes (the same rules as
`PUT /assets/{asset_id}/content`); the response is then `200`.'
tags:
- Assets
security:
- bearerAuth: []
x-required-permission: asset.import
x-required-scope: website
x-required-credential: write
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AssetImportRequest'
responses:
'200':
$ref: '#/components/responses/AssetReplaced'
'201':
$ref: '#/components/responses/AssetCreated'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'422':
$ref: '#/components/responses/Unprocessable'
'429':
$ref: '#/components/responses/TooManyRequests'
'503':
$ref: '#/components/responses/ServiceUnavailable'
components:
headers:
RetryAfter:
description: Seconds to wait before retrying.
schema:
type: integer
ETag:
description: Strong validator for the current representation.
schema:
type: string
Location:
description: Canonical URL of the created or affected resource.
schema:
type: string
format: uri
WWWAuthenticate:
description: 'Bearer challenge (RFC 9110 §11.6.1, RFC 6750 §3).
Carries `error="invalid_token"` when a credential was presented but
could not be resolved. `/api/v1` uses the `api` realm; OAuth
protected-resource metadata (RFC 9728) is advertised by MCP only.
'
schema:
type: string
example: Bearer realm="api", error="invalid_token"
RateLimitPolicy:
description: 'The applicable quota policy (draft-ietf-httpapi-ratelimit-headers-11).
'
schema:
type: string
example: '"write";q=120;w=60'
RateLimit:
description: 'The remaining quota and seconds until the window resets
(draft-ietf-httpapi-ratelimit-headers-11).
'
schema:
type: string
example: '"write";r=119;t=42'
schemas:
Asset:
type: object
additionalProperties: false
required:
- id
- filename
- content_type
- byte_size
- width
- height
- relative_url
- created_at
- updated_at
- storage
properties:
id:
type: string
format: uuid
filename:
type: string
content_type:
type:
- string
- 'null'
byte_size:
type: integer
minimum: 0
description: Original bytes plus every generated variant.
width:
type:
- integer
- 'null'
height:
type:
- integer
- 'null'
relative_url:
type: string
description: Site-relative URL; the `?v=` token changes when the bytes change.
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
storage:
$ref: '#/components/schemas/StorageInfo'
AssetSummary:
type: object
additionalProperties: false
required:
- id
- filename
- content_type
- byte_size
- width
- height
- relative_url
- created_at
- updated_at
properties:
id:
type: string
format: uuid
filename:
type: string
content_type:
type:
- string
- 'null'
byte_size:
type: integer
minimum: 0
width:
type:
- integer
- 'null'
height:
type:
- integer
- 'null'
relative_url:
type: string
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
AssetsCollection:
type: object
additionalProperties: false
required:
- data
- pagination
properties:
data:
type: array
items:
$ref: '#/components/schemas/AssetSummary'
pagination:
$ref: '#/components/schemas/Pagination'
Problem:
type: object
example:
type: https://pageweave.dev/errors/forbidden
title: Forbidden
status: 403
detail: The API key lacks the page.create permission for this website.
instance: /api/v1/websites/019f9c2a-6a1b-7a3d-8f2e-4b6c8d0e1f23/pages
request_id: 019fc8e5-8f6a-9b7c-8d85-4f6a7b8c9d0e
required_permission: page.create
required_permission_scope: website
required_credential_scope: write
required:
- type
- title
- status
- instance
properties:
type:
type: string
format: uri
title:
type: string
status:
type: integer
detail:
type: string
instance:
type: string
request_id:
type:
- string
- 'null'
errors:
type: array
items:
type: object
additionalProperties: false
required:
- field
- detail
properties:
field:
type: string
detail:
type: string
code:
type: string
upgrade_url:
type: string
required_permission:
type:
- string
- 'null'
description: Declared endpoint permission; null for account-level endpoints with no resource permission.
required_permission_scope:
type:
- string
- 'null'
description: Scope the permission resolves in (workspace, website, environment); null when there is no resource permission.
required_credential_scope:
type:
- string
- 'null'
description: The read/write scope the presented bearer credential lacks; present on credential-ceiling 403s.
retry_after_seconds:
type: integer
minimum: 1
description: Seconds until the quota resets (RFC 9457 extension member, on too-many-requests only). Authoritative over retry_at when clocks differ.
retry_at:
type: string
format: date-time
description: UTC "not before" timestamp — when the quota window ends (RFC 9457 extension member, on too-many-requests only).
suggested_path:
type: string
description: First free path for a restore whose original path is taken, when one can be suggested (RFC 9457 extension member; nothing is renamed automatically).
template_pages:
type: array
description: Live template pages that reference a table whose deletion was refused (RFC 9457 extension member).
items:
type: object
additionalProperties: false
required:
- id
- path
properties:
id:
type: string
format: uuid
path:
type: string
conflicts:
type: array
description: Release items edited by someone else after the caller's last edit (RFC 9457 extension member).
items:
type: object
additionalProperties: false
required:
- type
- identifier
- mine_version
- latest_version
- latest_author
properties:
type:
type: string
identifier:
type: string
mine_version:
type: integer
latest_version:
type: integer
latest_author:
type:
- string
- 'null'
matches:
type: array
description: Candidate short ids for an ambiguous feedback reference (RFC 9457 extension member).
items:
type: string
items:
type: array
description: Identifiers that made a release selection invalid (RFC 9457 extension member).
items:
type: string
nameservers:
type: array
description: Live parent NS answer that still delegates a zone to PageWeave, sent with a refused zone deletion (RFC 9457 extension member).
items:
type: string
existing_id:
type: string
format: uuid
description: Identifier of the existing resource that caused a conflict, such as a pending invitation (RFC 9457 extension member).
AssetImportRequest:
type: object
additionalProperties: false
description: Exactly one of `url` or `base64` must be present.
properties:
url:
type: string
format: uri
description: HTTPS URL to fetch. Private-network targets are rejected.
base64:
type: string
description: Base64 bytes, capped at 20 KB after decoding. Requires `filename` and `content_type`.
filename:
type: string
description: Required with `base64`; rejected with `url` or `asset_id` (a replacement preserves the existing filename).
content_type:
type: string
description: Required with `base64` and must match the decoded bytes; rejected with `url`.
asset_id:
type: string
format: uuid
description: Replace this asset's bytes instead of creating a new asset.
StorageInfo:
type: object
additionalProperties: false
required:
- used_bytes
- limit_bytes
properties:
used_bytes:
type: integer
minimum: 0
limit_bytes:
type: integer
minimum: 0
Pagination:
type: object
additionalProperties: false
required:
- limit
- has_more
- next_cursor
properties:
limit:
type: integer
minimum: 0
has_more:
type: boolean
next_cursor:
type:
- string
- 'null'
responses:
ContentTooLarge:
description: The payload exceeds the file-size or storage limit
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
TooManyRequests:
description: A rate limit was exceeded
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
RateLimit-Policy:
$ref: '#/components/headers/RateLimitPolicy'
RateLimit:
$ref: '#/components/headers/RateLimit'
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
ServiceUnavailable:
description: A dependency is temporarily unavailable
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
AssetReplaced:
description: The asset's bytes were replaced (id and filename unchanged)
headers:
RateLimit-Policy:
$ref: '#/components/headers/RateLimitPolicy'
RateLimit:
$ref: '#/components/headers/RateLimit'
content:
application/json:
schema:
$ref: '#/components/schemas/Asset'
Unauthorized:
description: Missing, invalid, expired, or revoked credential
headers:
WWW-Authenticate:
$ref: '#/components/headers/WWWAuthenticate'
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
AssetCreated:
description: The asset was created
headers:
Location:
$ref: '#/components/headers/Location'
RateLimit-Policy:
$ref: '#/components/headers/RateLimitPolicy'
RateLimit:
$ref: '#/components/headers/RateLimit'
content:
application/json:
schema:
$ref: '#/components/schemas/Asset'
Unprocessable:
description: The payload could not be processed
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
BadRequest:
description: The request is malformed or carries unknown query parameters
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
Forbidden:
description: The session, credential, or role does not permit the action
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
NotFound:
description: The resource does not exist or is not visible to this caller
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
NotModified:
description: The representation has not changed
headers:
ETag:
$ref: '#/components/headers/ETag'
parameters:
Limit:
name: limit
in: query
required: false
description: Page size (1-100, default 25).
schema:
type: integer
minimum: 1
maximum: 100
default: 25
Cursor:
name: cursor
in: query
required: false
description: Opaque keyset cursor from the previous page's `pagination.next_cursor`.
schema:
type: string
UploadFilename:
name: filename
in: query
required: false
description: 'File name for a raw-body upload. Ignored when a multipart `file` part
carries its own name.
'
schema:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key created in Settings → API keys. Send
`Authorization: Bearer pagew_...`. A key''s scopes (`read`, `write`) are
a ceiling: a read-only key cannot write even when its owner''s role
allows it.
'