Templates, API Keys & Billing

Base URL: https://api.guilde.work/guilde/api/v1

Templates

Pre-built guild configurations with operators, roles, and settings.

List templates

curl https://api.guilde.work/guilde/api/v1/templates

No authentication required. Returns public templates.

Get template

curl https://api.guilde.work/guilde/api/v1/templates/{templateId}

Apply template

Creates a new guild from a template, including operators and workspace.

curl -X POST https://api.guilde.work/guilde/api/v1/templates/{templateId}/apply \
  -H "Authorization: Bearer gld_your_api_key" \
  -d '{ "name": "My Marketing Team", "slug": "marketing-team" }'

API Keys

Personal API keys for programmatic access (MCP, CLI, integrations).

Keys use the gld_ prefix and support scoped access.

Available scopes

Scope	Access
`*`	Full access
`mcp`	MCP server access
`conversations:read`	Read conversations
`conversations:write`	Send messages
`work-items:read`	Read work items
`work-items:write`	Create/update work items
`operators:read`	Read operator data
`workspace:read`	Read workspace files
`workspace:write`	Create documents

List keys

curl https://api.guilde.work/guilde/api/v1/api-keys \
  -H "Authorization: Bearer <jwt_token>"

Create key

curl -X POST https://api.guilde.work/guilde/api/v1/api-keys \
  -H "Authorization: Bearer <jwt_token>" \
  -d '{ "name": "MCP Access", "scopes": ["mcp"], "expiresInDays": 90 }'

The raw key is returned only once in the response. Store it securely.

Revoke key

curl -X DELETE https://api.guilde.work/guilde/api/v1/api-keys/{keyId} \
  -H "Authorization: Bearer <jwt_token>"

Billing

User-level billing with credits and subscriptions.

Get billing info

curl https://api.guilde.work/guilde/api/v1/billing \
  -H "Authorization: Bearer gld_your_api_key"

Returns subscription status and credits balance.

Available plans

curl https://api.guilde.work/guilde/api/v1/billing/plans \
  -H "Authorization: Bearer gld_your_api_key"

Credits balance

curl https://api.guilde.work/guilde/api/v1/billing/credits \
  -H "Authorization: Bearer gld_your_api_key"

Stripe portal

Opens Stripe customer portal for subscription management.

curl -X POST https://api.guilde.work/guilde/api/v1/billing/portal \
  -H "Authorization: Bearer gld_your_api_key" \
  -d '{ "returnUrl": "https://app.guilde.work/settings" }'

Checkout

Create a checkout session for subscriptions or credit packs.

curl -X POST https://api.guilde.work/guilde/api/v1/checkout/generate \
  -H "Content-Type: application/json" \
  -d '{ "planId": "guilde_credits", "packId": "pack_100" }'

Templates & API Keys