Organization
View and update your organization's settings.
The organization is the top-level tenant in Spedy. All boards, users, and data belong to an organization. Most organization settings require the settings:edit permission.
Get Current Organization
GET /api/v1/organizations/currentReturns the organization of the currently authenticated user.
Example Response
{
"id": "org_abc123",
"name": "Acme Corp",
"slug": "acme-corp",
"logo": "https://cdn.spedy.ai/logos/acme.png",
"createdAt": "2025-01-01T00:00:00Z"
}Update Organization
PATCH /api/v1/organizations/currentPermission required: settings:edit
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | No | Organization name |
| slug | string | No | URL-friendly slug (lowercase, alphanumeric, hyphens) |
| logo | string | No | Logo URL |
Example Request
{
"name": "Acme Corporation",
"slug": "acme-corporation"
}Delete Organization
DELETE /api/v1/organizations/currentPermission required: settings:edit
Permanently deletes the organization and all its data. This action cannot be undone.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| confirmation | string | Yes | Must match the organization name to confirm deletion |