API Reference

PythonWD HTTP API

Base URL: https://pkg.pythonwd.com · Current version: v3.14.3

Authentication. Send Authorization: Bearer <token> on every request except /api/v2/health. Generate tokens with pythonwd login --sso or from your account settings. Community mirror reads are unauthenticated.
GET /simple/ PEP 503 simple package index

Returns the PEP 503-compatible simple index of all projects available on the mirror. Point pip at this endpoint via --index-url and dependency resolution works without further changes. Use /simple/<project>/ to list file links for one project.

Request
shell 
curl https://pkg.pythonwd.com/simple/requests/
Response
html 
<!DOCTYPE html>
<html>
  <body>
    <a href="/packages/requests-2.32.3-py3-none-any.whl#sha256=...">requests-2.32.3-py3-none-any.whl</a>
  </body>
</html>
Query Parameters
ParameterTypeDescription
platformstringFilter to a wheel platform tag, e.g. win_amd64
python_versionstringFilter to a compatible CPython version
GET /packages/ Package artifact downloads

Serves the actual wheel and sdist artifacts referenced by /simple/. Files are content- addressed and immutable, so they can be cached indefinitely by CI runners and air-gapped mirrors.

Request
shell 
curl -O https://pkg.pythonwd.com/packages/requests-2.32.3-py3-none-any.whl
Response Headers
HeaderDescription
Content-Typeapplication/octet-stream
ETagSHA-256 digest of the artifact
Cache-Controlpublic, max-age=31536000, immutable
POST /api/v2/telemetry/collect Application performance telemetry collection

Accepts batched application telemetry events emitted by the PythonWD SDK client (client.telemetry.start(...)) for fleet-wide visibility into dependency usage and runtime performance.

Request Body
json 
{
  "app": "billing-service",
  "host": "WIN-PROD-042",
  "events": [
    {"type": "startup", "duration_ms": 812, "python_version": "3.12.4"},
    {"type": "dependency_import", "package": "requests", "duration_ms": 14}
  ]
}
Response
json 
{"accepted": 2, "rejected": 0}
Status Codes
CodeMeaning
202Events accepted for processing
400Malformed event payload
401Missing or invalid bearer token
POST /api/v2/metrics/ingest Time-series metrics ingestion

Ingests numeric time-series metrics (counters, gauges, histograms) tagged by application and host, for dashboards and alerting on top of your Windows Python fleet.

Request Body
json 
{
  "metrics": [
    {"name": "resolve.duration_ms", "value": 431, "tags": {"platform": "win_amd64"}},
    {"name": "mirror.cache_hit_ratio", "value": 0.94, "type": "gauge"}
  ]
}
Response
json 
{"ingested": 2}
GET /api/v2/health Service health check

Unauthenticated liveness/readiness probe suitable for load balancers and uptime monitors.

Response
json 
{
  "status": "ok",
  "version": "3.14.3",
  "mirror_sync_lag_seconds": 4
}
Need a capability that isn't listed here — bulk export, webhook subscriptions, custom SAML mappings? Contact enterprise@pythonwd.com.