# Topdesk API Test Lab

> Use when testing live TOPdesk REST/API access, authentication, endpoint availability, paging behavior, response status codes, payload shapes, demo tenants, smoke tests, regression checks, and API readiness before building Power BI, Python, PowerShell, or AI features.

- Skill: `rweisssieker-xp/topdesk-api-test-lab` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add rweisssieker-xp/topdesk-api-test-lab`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rweisssieker-xp/topdesk-api-test-lab/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: rweisssieker-xp (https://skillmd.com/u/rweisssieker-xp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rweisssieker-xp/topdesk-api-test-lab

---


# TOPdesk API Test Lab

Use this skill before depending on a TOPdesk tenant for automation, Power BI refresh, migration, or AI workflows.

## Workflow

1. Confirm the base URL, authentication mode, and endpoint list without storing secrets.
2. Run smoke tests for status code, content type, JSON shape, row count, paging, and latency.
3. Separate authentication failures from permission failures and missing endpoints.
4. Record what works, what is blocked, and which features are safe to test live.
5. Feed successful endpoint paths into tenant mapping, Power BI query design, Python, and PowerShell skills.

## Scripts

- Use `scripts/smoke_topdesk_api.py` with `TOPDESK_BASE_URL`, `TOPDESK_USERNAME`, and `TOPDESK_APP_PASSWORD`.
- Optional: pass `--endpoint name=/tas/api/path` to test additional tenant endpoints.