Showpad

Showpad Tags API

The tags API from Showpad — 12 operation(s) for tags.

GitHub OpenAPI

Operations 20

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 /tags.json List tags (legacy endpoint) · /tags.json #
Ask an LLM
“Can I still list tags through the older tags.json endpoint?”
“How do I find a tag by external ID using the legacy list?”
Tell an agent
Using the legacy tags.json endpoint, list all tags.
With the older list endpoint, find tags with external ID {externalId}.
POST /tags.json Create a tag (legacy endpoint) · /tags.json #
Ask an LLM
“Is the old .json endpoint still usable for creating a tag?”
“Can I give a tag a description when creating it the legacy way?”
Tell an agent
Using the legacy create endpoint, create tag {name}.
Via tags.json, create tag {name} described as {description}.
GET /tags/count.json Count tags · /tags/count.json #
Ask an LLM
“How many tags exist in our Showpad library?”
“What's the number of tags matching a given name?”
Tell an agent
Count all tags.
Count the tags named {name}.
GET /tags/description.json Describe the tag data model · /tags/description.json #
Ask an LLM
“What fields does a tag object have in the legacy API?”
“Where can I see the allowed calls and parameters for tags?”
Tell an agent
Describe the tag model and its available API calls.
Show me the property definitions for the tag resource.
GET /tags/{id1}/assets/{id2}.json Link or unlink a tag and asset via GET · /tags/{id1}/assets/{id2}.json #
Ask an LLM
“Is there a GET override for linking or unlinking from the tag's side?”
“Can I change a tag-to-asset assignment using the method parameter on the tag path?”
Tell an agent
From tag {id1}, use method {method} to change its link to asset {id2}.
Through GET on the tag path, apply {method} to tag {id1} and asset {id2}.
GET /tags/{id}.json Get a tag (legacy endpoint) · /tags/{id}.json #
Ask an LLM
“Can I fetch one tag through the older .json endpoint?”
“What does the legacy single-tag response contain?”
Tell an agent
Using the legacy endpoint, get tag {id}.
Fetch tag {id} from tags/{id}.json.
PUT /tags/{id}.json Update a tag (legacy PUT) · /tags/{id}.json #
Ask an LLM
“How do I rename a tag with a PUT on the legacy endpoint?”
“Can I move a tag to another division with a legacy PUT?”
Tell an agent
PUT a legacy update renaming tag {id} to {name}.
With legacy PUT, move tag {id} to division {divisionId}.
POST /tags/{id}.json Update a tag (legacy POST .json) · /tags/{id}.json #
Ask an LLM
“Is there a POST variant on the legacy .json path for editing a tag?”
“Can I change a tag's description through the old POST update?”
Tell an agent
Via legacy POST to tags/{id}.json, set the description to {description}.
Using the old POST .json update, set tag {id}'s external ID to {externalId}.
DELETE /tags/{id}.json Delete a tag (legacy endpoint) · /tags/{id}.json #
Ask an LLM
“Can I still delete a tag with the legacy .json endpoint?”
“What's the older way to remove a tag by ID?”
Tell an agent destructive · confirm first
Using the legacy endpoint, delete tag {id}.
Remove tag {id} via tags/{id}.json.
GET /tags/{id}/assets.json List assets with a tag · /tags/{id}/assets.json #
Ask an LLM
“Which assets are labeled with a particular tag?”
“Can I see only the shareable assets under one tag?”
Tell an agent
List the assets tagged with tag {id}.
Show {filetype} assets under tag {id}.
POST /tags/{id}/assets.json Create a new asset under a tag · /tags/{id}/assets.json #
Ask an LLM
“How do I upload a new asset that's already tagged?”
“Can I create an asset directly inside a tag in one call?”
Tell an agent
Create asset {name} under tag {id}.
Upload {file} as a new asset tagged with tag {id}.
GET /tags List tags · List all Tags #
Ask an LLM
“How do I list the tags available to me, filtered by division or tag category?”
“Can I find a tag by its exact name?”
Tell an agent
List tags in tag categories {tagCategoryIds}.
Find the tag whose exact name is {exactName}.
POST /tags Create a tag · Create a tag #
Ask an LLM
“How do I create a new tag in a division?”
“Can I record which external service a new tag came from?”
Tell an agent
Create tag {name} in division {division}.
Create tag {name} in division {division} from external service {externalServiceId}.
GET /tags/{tagId} Get a tag · Retrieve a Tag #
Ask an LLM
“How do I retrieve a single tag by its ID?”
“What details are returned for one tag?”
Tell an agent
Get tag {tagId}.
Show the details of tag {tagId}.
POST /tags/{tagId} Rename a tag · Update a Tag #
Ask an LLM
“How do I rename an existing tag?”
“Is the name the only thing I can change when updating a tag?”
Tell an agent
Rename tag {tagId} to {name}.
Change the name of tag {tagId} to {name}.
DELETE /tags/{tagId} Delete a tag · Delete a Tag #
Ask an LLM
“How do I delete a tag we no longer use?”
“What happens to a tag when I remove it?”
Tell an agent destructive · confirm first
Delete tag {tagId}.
Remove tag {tagId} permanently.

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-tags-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-tags-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-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Showpad Tags 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 tags 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 (158 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/showpad/refs/heads/main/openapi/showpad-tags-api-openapi.yml