Reference

Quick links to API endpoints, environment mappings, and the platform-level reference documentation.

API endpoints

HeadshotMarketing exposes GraphQL on the Burdenoff Workspaces and Global gateways.

Gateway	Production	Alpha	Local
Workspace public	https://graphqlworkspaces.burdenoff.com/workspaces/graphql	https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql	http://127.0.0.1:4003/workspaces/graphql
Global public	https://graphql.burdenoff.com/global/graphql	https://alphagraphql.burdenoff.com/global/graphql	http://127.0.0.1:4000/global/graphql

Authentication is via the Burdenoff identity layer (OAuth2 device code, PKCE, or client credentials). See Account & Sign-in.

Ecosystem packages

Package	Registry	Install
@headshotmarketing/sdk	npmjs	bun add @headshotmarketing/sdk
headshotmarketing-sdk	PyPI	pip install headshotmarketing-sdk
@headshotmarketing/cli	npmjs	bun add -g @headshotmarketing/cli
@headshotmarketing/mcp	npmjs	bun add -g @headshotmarketing/mcp

Repositories

All repos live under github.com/algoshred:

• headshotmarketing-app — Web, Android, iOS, Electron app shell
• headshotmarketing-website — Marketing site
• headshotmarketing-sdk-node — TypeScript SDK
• headshotmarketing-sdk-python — Python SDK
• headshotmarketing-cli — CLI
• headshotmarketing-browser-extension — Chrome extension
• headshotmarketing-code-extension — VS Code extension
• headshotmarketing-mcp — MCP server
• headshotmarketing-doctor — E2E test suite
• wspace-headshotmarketing-svc — Backend microservice
• headshotmarketing-docs — This documentation site

Platform docs

For platform-level concerns — auth, RBAC, billing, tags, files, webhooks, GraphQL pagination, and more — see the Burdenoff Platform Documentation.

Pages

• API Reference — endpoint details and authentication headers
• Changelog — recent changes across the ecosystem