Authentication

How to authenticate with the Guilde API using JWT or API keys.

Authentication

The Guilde API supports two authentication methods:

API keys use the gld_ prefix.

Authorization: Bearer gld_your_api_key_here

Create an API Key

  1. Go to Guilde Settings > API Keys
  2. Click Create
  3. Name your key
  4. Copy immediately — shown only once

Scopes

ScopeDescription
*Full access (default)
mcpMCP server access only
conversations:readRead conversations
conversations:writeSend messages
work-items:readRead work items
work-items:writeCreate/update work items
operators:readRead operator data
workspace:readRead workspace files
workspace:writeCreate documents

JWT Tokens

Obtained via login:

curl -X POST https://api.guilde.work/guilde/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your_password"}'

Use the access_token as Bearer token.

Templates & API Keys

API reference for guild templates, API key management, and billing.

On this page

AuthenticationAPI Keys (recommended for integrations)Create an API KeyScopesJWT Tokens