Showpad

Showpad Assets API

The assets API from Showpad — 16 operation(s) for assets.

GitHub OpenAPI

Operations 26

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /assets.json List assets (legacy endpoint) · /assets.json #
Ask an LLM
“Can I still list assets with the older .json assets endpoint?”
“How do I filter the legacy asset list to only shareable or sensitive files?”
Tell an agent
Using the legacy assets.json endpoint, list assets of file type {filetype}.
With the older list endpoint, find assets whose original file name is {originalName}.
POST /assets.json Upload an asset (legacy endpoint) · /assets.json #
Ask an LLM
“Is the old .json create-asset endpoint still usable for uploading a file?”
“Can I set an expiry date when creating an asset the legacy way?”
Tell an agent
Using the legacy create endpoint, upload {file} as an asset named {name}.
Via assets.json, create asset {name} that expires at {expiresAt}.
GET /assets/count.json Count assets · /assets/count.json #
Ask an LLM
“How many assets are in our library?”
“What's the count of downloadable assets right now?”
Tell an agent
Count all assets.
Count the assets with file type {filetype}.
GET /assets/description.json Describe the asset data model · /assets/description.json #
Ask an LLM
“What properties does the asset model have in the legacy API?”
“Where can I see which asset calls and parameters are allowed?”
Tell an agent
Describe the asset model and its available API calls.
Show me the field definitions for the asset resource.
GET /assets/{id1}/tags/{id2}.json Link or unlink an asset and tag via GET · /assets/{id1}/tags/{id2}.json #
Ask an LLM
“Is there a GET-based override to tag or untag an asset for clients that can't send POST?”
“Can I change an asset's tag assignment from the asset side with the method parameter?”
Tell an agent
From asset {id1}, use method {method} to change its link to tag {id2}.
Through GET on the asset path, apply {method} to asset {id1} and tag {id2}.
GET /assets/{id}.json Get an asset (legacy endpoint) · /assets/{id}.json #
Ask an LLM
“Can I fetch one asset through the older .json endpoint?”
“What does the legacy single-asset response include?”
Tell an agent
Using the legacy endpoint, get asset {id}.
Fetch asset {id} from assets/{id}.json.
PUT /assets/{id}.json Update an asset (legacy PUT) · /assets/{id}.json #
Ask an LLM
“How do I edit an asset's details with a PUT on the legacy endpoint?”
“Can I make an asset non-downloadable with a legacy PUT update?”
Tell an agent
PUT a legacy update renaming asset {id} to {name}.
With legacy PUT, set downloadable to {isDownloadable} on asset {id}.
POST /assets/{id}.json Update an asset (legacy POST .json) · /assets/{id}.json #
Ask an LLM
“Is there a POST variant on the legacy .json path for editing an asset?”
“Can I mark an asset sensitive through the old POST update endpoint?”
Tell an agent
Via legacy POST to assets/{id}.json, set sensitive to {isSensitive}.
Using the old POST .json update, change asset {id}'s description to {description}.
DELETE /assets/{id}.json Delete an asset (legacy endpoint) · /assets/{id}.json #
Ask an LLM
“Can I still delete an asset using the legacy .json endpoint?”
“What's the older way to remove an asset by its ID?”
Tell an agent destructive · confirm first
Using the legacy endpoint, delete asset {id}.
Remove asset {id} via assets/{id}.json.
GET /assets/{id}/comments.json List comments on an asset · /assets/{id}/comments.json #
Ask an LLM
“What comments have people left on a particular asset?”
“Can I see only the comments on an asset created after a certain date?”
Tell an agent
List the comments on asset {id}.
Show comments on asset {id} created since {createdSince}.
POST /assets/{id}/comments.json Comment on an asset · /assets/{id}/comments.json #
Ask an LLM
“How do I add a comment to a specific asset?”
“Can an unregistered visitor's comment be recorded against an asset?”
Tell an agent
Comment {message} on asset {id}.
Post the comment {message} on asset {id} for unregistered user {unregisteredUserFirstName}.
GET /assets/{id}/tags.json List an asset's tags · /assets/{id}/tags.json #
Ask an LLM
“Which tags are on a given asset?”
“Can I check whether an asset carries a tag with a specific name?”
Tell an agent
List the tags on asset {id}.
Check if asset {id} has a tag named {name}.
POST /assets/{id}/tags.json Create a new tag on an asset · /assets/{id}/tags.json #
Ask an LLM
“How do I create a brand-new tag and apply it to an asset in one call?”
“Can I set the division of a tag I'm creating on an asset?”
Tell an agent
Create tag {name} and add it to asset {id}.
Add a new tag {name} in division {divisionId} to asset {id}.
GET /assets List assets · List all Assets #
Ask an LLM
“How do I list the assets in our Showpad library filtered by tag or division?”
“Can I look up assets by their external IDs or slugs?”
Tell an agent
List assets in divisions {divisionIds}.
List assets tagged {tagIds}.
POST /assets Create an asset record · Create an asset #
Ask an LLM
“How do I create a new asset record in a division?”
“Can I set languages, countries and authors when creating an asset?”
Tell an agent
Create an asset named {name} in division {division}.
Create asset {name} in division {division} with tags {tags}.
POST /assets/query Search assets with ShowQL · Query assets using ShowQL #
Ask an LLM
“Can I filter assets with complex conditions on metadata, languages and countries?”
“How do I page through a large ShowQL result set with a cursor?”
Tell an agent
Query assets with the ShowQL expression {query}.
Get the next page of ShowQL results for {query} using cursor {cursor}.
GET /assets/{assetId} Get an asset · Retrieve an Asset #
Ask an LLM
“How do I retrieve one asset's metadata by its ID?”
“What details come back for a single asset?”
Tell an agent
Get asset {assetId}.
Show the metadata of asset {assetId}.
POST /assets/{assetId} Update an asset · Update an asset #
Ask an LLM
“How do I archive an asset or change its permissions?”
“Can I update an asset's languages and localization?”
Tell an agent
Archive asset {assetId} by setting archived to {isArchived}.
Set the tags of asset {assetId} to {tags}.
DELETE /assets/{assetId} Permanently delete an asset · Delete an asset #
Ask an LLM
“How do I permanently delete an asset from our library?”
“Can a deleted asset be recovered afterwards?”
Tell an agent destructive · confirm first
Permanently delete asset {assetId}.
Remove asset {assetId} from the Showpad library for good.
GET /assets/{assetId}/files List an asset's file versions · List Asset Files #
Ask an LLM
“Which file versions are attached to an asset?”
“Can I see the original and processed files for one asset?”
Tell an agent
List the files of asset {assetId}.
Show all file versions belonging to asset {assetId}.
POST /assets/{assetId}/files Attach a new file to an asset · Create an Asset File #
Ask an LLM
“How do I upload a new file version to an existing asset?”
“Can I send an MD5 checksum when adding a file to an asset?”
Tell an agent
Attach a new file to asset {assetId}.
Add file {name} with checksum {contentMD5} to asset {assetId}.
GET /assets/{assetId}/files/{fileId} Get an asset file's metadata · Retrieve an Asset File #
Ask an LLM
“How do I see the metadata of one specific file on an asset?”
“Does fetching a single asset file return the binary content?”
Tell an agent
Get file {fileId} of asset {assetId}.
Show metadata for file {fileId} on asset {assetId}.

Documentation

📖
Documentation
https://developer.showpad.com/docs/apis/
📖
APIReference
https://developer.showpad.com/docs/apis/references/v3
📖
Authentication
https://developer.showpad.com/docs/apis/concepts/authentication
📖
APIReference
https://developer.showpad.com/docs/apis/references/v4
📖
Documentation
https://developer.showpad.com/docs/apis/users/SCIM

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/showpad/refs/heads/main/openapi/showpad-assets-api-openapi.yml

Other Resources

🔗
Versioning
https://developer.showpad.com/docs/apis/concepts/versions
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/showpad/refs/heads/main/errors/showpad-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/showpad/refs/heads/main/data-model/showpad-data-model.yml

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/showpad:showpad-assets-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

showpad-assets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Showpad Assets API
  contact:
    name: Showpad
    email: support@showpad.com
    url: https://help.showpad.com/hc/en-us/requests/new
  termsOfService: https://www.showpad.com/terms-of-service
  x-audience: external-partner
  x-refined-note:
  - x-logo differs across the merged source definitions and was not carried
  - x-serviceName differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged assets across 2 of this provider''s published API definitions: showpad-v3-openapi-original.yml, showpad-v4-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{subdomain}.showpad.biz/api/v3/
  description: Production server
  x-environment: production
  variables:
    subdomain:
      default: customer
      description: Showpad customer subdomain
- url: https://{subdomain}.api.showpad.com/v4
  description: Production server
  x-environment: production
  variables:
    subdomain:
      default: customer
      description: Showpad customer subdomain
tags:


# --- truncated at 32 KB (384 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/showpad/refs/heads/main/openapi/showpad-assets-api-openapi.yml