Showpad

Showpad Divisions API

The divisions API from Showpad — 17 operation(s) for divisions.

GitHub OpenAPI

Operations 24

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 /divisions.json List divisions with filters (v3) · /divisions.json #
Ask an LLM
“Which divisions have asset sharing enabled, using the older v3 list?”
“Can I filter the v3 division list by name or external ID?”
Tell an agent
List v3 divisions named {name}.
Show v3 divisions where asset sharing is {hasDivisionAssetSharingEnabled}.
POST /divisions.json Create a division · /divisions.json #
Ask an LLM
“How do I set up a new division for another business unit?”
“Can I turn on division asset sharing when creating a division?”
Tell an agent
Create a division called {name}.
Create division {name} with external ID {externalId}.
GET /divisions/count.json Count divisions · /divisions/count.json #
Ask an LLM
“How many divisions exist in our account?”
“What number of divisions share assets with others?”
Tell an agent
Count all divisions.
Count divisions named {name}.
GET /divisions/description.json Describe the Division model and its APIs · /divisions/description.json #
Ask an LLM
“What fields make up the Division model?”
“Which division endpoints are available according to the self-description?”
Tell an agent
Show the Division model description.
Fetch the division resource metadata and available APIs.
GET /divisions/{id1}/usergroups/{id2}.json Link or unlink a division and group via GET · /divisions/{id1}/usergroups/{id2}.json #
Ask an LLM
“Is there a GET call that links or unlinks a division and a user group depending on a method value?”
“Can I switch a group's division membership with one method parameter?”
Tell an agent
Use method {method} to link or unlink division {id1} and user group {id2} with the combined GET call.
Run the method-switched division-group call {method} for division {id1} and group {id2}.
GET /divisions/{id}.json Retrieve a division (v3) · /divisions/{id}.json #
Ask an LLM
“How do I fetch one division's record with the older v3 endpoint?”
“Can I expand related data when reading a division in v3?”
Tell an agent
Get division {id} from the v3 endpoint.
Fetch v3 division {id} with {expand} expanded.
PUT /divisions/{id}.json Update a division with PUT · /divisions/{id}.json #
Ask an LLM
“How do I rename a division with a PUT request?”
“Can I toggle division asset sharing via PUT?”
Tell an agent
PUT a new name {name} on division {id}.
Using PUT, set asset sharing to {hasDivisionAssetSharingEnabled} for division {id}.
POST /divisions/{id}.json Update a division with POST · /divisions/{id}.json #
Ask an LLM
“Is there a POST alternative for editing a division when PUT isn't allowed?”
“Can I change a division's external ID through a POST update?”
Tell an agent
Via the POST update call, set division {id}'s external ID to {externalId}.
POST a rename of division {id} to {name}.
DELETE /divisions/{id}.json Delete a division · /divisions/{id}.json #
Ask an LLM
“How do I permanently remove a division?”
“What call deletes a division by its ID?”
Tell an agent destructive · confirm first
Delete division {id}.
Remove the division with ID {id} from the account.
GET /divisions/{id}/assets.json List a division's assets · /divisions/{id}/assets.json #
Ask an LLM
“What content assets live in a given division?”
“Can I list only the downloadable or shareable assets of a division?”
Tell an agent
List assets in division {id}.
Show division {id} assets with file type {filetype}.
POST /divisions/{id}/assets.json Add an asset to a division · /divisions/{id}/assets.json #
Ask an LLM
“How do I upload a new file into a division's library?”
“Can I mark an asset as sensitive or non-downloadable when adding it to a division?”
Tell an agent
Upload {file} as an asset named {name} to division {id}.
Add a URL asset {url} to division {id} that expires {expiresAt}.
GET /divisions/{id}/comments.json List comments in a division · /divisions/{id}/comments.json #
Ask an LLM
“What comments have been posted within a division?”
“Can I page through a division's comments sorted by date?”
Tell an agent
List comments for division {id}.
Show {limit} comments from division {id} sorted by {sort}.
GET /divisions/{id}/tags.json List a division's tags · /divisions/{id}/tags.json #
Ask an LLM
“What tags are defined in a particular division?”
“Can I list only unfinished or customer-type tags in a division?”
Tell an agent
List tags in division {id}.
Show division {id} tags with status {status}.
POST /divisions/{id}/tags.json Add a tag to a division · /divisions/{id}/tags.json #
Ask an LLM
“How do I create a new tag inside a division?”
“Which values do I need to add a tag to a division?”
Tell an agent
Add a tag of type {type} to division {id} with divisionId {divisionId}.
Create a {type} tag in division {divisionId} through division {id}.
GET /divisions/{id}/tickets.json List a division's tickets · /divisions/{id}/tickets.json #
Ask an LLM
“Which tickets belong to a given division?”
“Can I filter a division's tickets to synced ones only?”
Tell an agent
List tickets for division {id}.
Show division {id} tickets where isSynced is {isSynced}.
GET /divisions/{id}/usergroups.json List a division's user groups · /divisions/{id}/usergroups.json #
Ask an LLM
“Which user groups are part of a given division?”
“Can I page through a division's groups?”
Tell an agent
List user groups in division {id}.
Show {limit} groups of division {id}.
POST /divisions/{id}/usergroups.json Add a group to a division · /divisions/{id}/usergroups.json #
Ask an LLM
“How do I add a new group entry to a division?”
“What details must I send when adding a group to a division?”
Tell an agent
Add a group to division {id} for {firstName} {lastName} ({email}), username {userName}, language {language}, active {isActive}.
Create a division {id} group entry using email {email}.
GET /divisions/{id}/users.json List a division's users · /divisions/{id}/users.json #
Ask an LLM
“Who are the users in a particular division?”
“Can I see only division users created since a certain date?”
Tell an agent
List users in division {id}.
Show division {id} users created since {createdSince}.
GET /divisions List divisions (v4) · List all Divisions #
Ask an LLM
“What's the v4 way to list all divisions in Showpad?”
“How do I page through divisions with the newer API?”
Tell an agent
Using v4, list all divisions.
Get {limit} v4 divisions starting at offset {offset}.
GET /divisions/{divisionId} Retrieve a division (v4) · Retrieve a Division #
Ask an LLM
“How do I get one division's details with the v4 API?”
“What does the v4 division object contain?”
Tell an agent
Retrieve v4 division {divisionId}.
Get the details of division {divisionId} from the v4 endpoint.

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://artifacts.apis.io/showpad/openapi/showpad-divisions-api-openapi.yml

Other Resources

🔗
Versioning
https://developer.showpad.com/docs/apis/concepts/versions
🔗
ErrorCatalog
https://artifacts.apis.io/showpad/errors/showpad-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/showpad/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-divisions-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

showpad-divisions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Showpad Divisions 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 divisions 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 (205 KB total) ---
# Full source: https://artifacts.apis.io/showpad/openapi/showpad-divisions-api-openapi.yml