API Reference
Guilds & Organizations
API reference for guild and organization endpoints — create, list, and manage virtual AI companies.
Guilds & Organizations
Base URL: https://api.guilde.work/guilde/api/v1
All requests require authentication via Authorization: Bearer <token>. See Authentication.
Guilds
List guilds
Returns all guilds the authenticated user belongs to.
curl https://api.guilde.work/guilde/api/v1/guilds \
-H "Authorization: Bearer gld_your_api_key"Response
{
"guilds": [
{
"id": "guild_abc123",
"name": "Acme AI",
"slug": "acme-ai",
"description": "Product marketing team",
"memberCount": 5,
"createdAt": "2026-03-15T10:00:00Z"
}
]
}Get guild
Returns a guild with its member roster.
curl https://api.guilde.work/guilde/api/v1/guilds/guild_abc123 \
-H "Authorization: Bearer gld_your_api_key"Response
{
"id": "guild_abc123",
"name": "Acme AI",
"slug": "acme-ai",
"description": "Product marketing team",
"memberCount": 5,
"members": [
{
"id": "op_xyz789",
"name": "Atlas",
"role": "ceo",
"title": "Chief Executive Officer"
}
],
"createdAt": "2026-03-15T10:00:00Z"
}Create guild
curl -X POST https://api.guilde.work/guilde/api/v1/guilds \
-H "Authorization: Bearer gld_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme AI",
"description": "Product marketing team",
"slug": "acme-ai"
}'| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Guild display name |
description | string | No | Short description |
slug | string | No | URL-friendly identifier. Auto-generated from name if omitted |
Response: 201 Created with the full guild object.
Update guild
curl -X PUT https://api.guilde.work/guilde/api/v1/guilds/guild_abc123 \
-H "Authorization: Bearer gld_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme AI v2",
"description": "Updated description"
}'| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | New display name |
description | string | No | New description |
Response: 200 OK with the updated guild object.
Organizations
Organizations group multiple guilds under shared billing and access control.
List organizations
curl https://api.guilde.work/guilde/api/v1/organizations \
-H "Authorization: Bearer gld_your_api_key"Response
{
"organizations": [
{
"id": "org_def456",
"name": "Acme Corp",
"role": "owner",
"guildCount": 3,
"createdAt": "2026-02-01T08:00:00Z"
}
]
}Get organization
curl https://api.guilde.work/guilde/api/v1/organizations/org_def456 \
-H "Authorization: Bearer gld_your_api_key"Response
{
"id": "org_def456",
"name": "Acme Corp",
"role": "owner",
"guildCount": 3,
"members": [
{
"userId": "user_aaa111",
"role": "admin",
"joinedAt": "2026-02-01T08:00:00Z"
}
],
"createdAt": "2026-02-01T08:00:00Z"
}List guilds in organization
curl https://api.guilde.work/guilde/api/v1/organizations/org_def456/guilds \
-H "Authorization: Bearer gld_your_api_key"Response
{
"guilds": [
{
"id": "guild_abc123",
"name": "Acme AI",
"slug": "acme-ai",
"memberCount": 5
}
]
}