Skip to main content
Workspace APIs will cover administrative objects that shape how a team uses Woes. These APIs should be treated as privileged because they can affect access, routing, customer-facing behavior, and support operations.

Planned resources

ResourcePurpose
Workspace profileCompany identity and workspace metadata.
MembersPeople with access to the workspace.
Roles and permissionsAccess boundaries for settings, inbox, automations, and context.
TagsManaged labels for conversations, issues, and accounts.
Custom fieldsStructured context fields for customers and conversations.
MacrosReusable replies and workflow actions.
AutomationsRules that tag, route, delay, or annotate support work.
Channel settingsWorkspace-level channel configuration.

Common use cases

Sync team membership

Keep support access aligned with another internal system.

Mirror CRM fields

Align tags or custom fields with your source of truth.

Manage support content

Keep macros and labels aligned with product documentation.

Build admin tooling

Create internal dashboards around workspace configuration.

Boundaries

Workspace administration APIs should require strong authentication and the right scopes. They should not be available through widget public keys. Do not expose:
  • Provider routing internals.
  • Service-role details.
  • Hidden model settings.
  • Operator-only debug traces.
  • Private customer data from another workspace.

Readiness criteria

  • Role and permission behavior is stable.
  • Writes are auditable enough for customer admins.
  • No-op saves do not grant unnecessary write access.
  • Table-backed resources preserve workspace ownership.
  • Public responses avoid internal-only configuration.