Overview

Organizations are containers for your workflow resources. Users can belong to multiple organizations, and all resources (API keys, definitions, executions, webhooks) are scoped to a specific organization.

Organization Properties

ID
Unique identifier for the organization (immutable, cannot be changed)
Name
Human-readable name for the organization (editable)
Owner
User ID of the organization owner (the user who created it)
Quotas
Resource limits including API key limit, definition limit, execution limit, and rate limit

Switching Organizations

If you belong to multiple organizations, you can switch between them using the organization selector in the header:

1

Open Organization Selector

Click the organization dropdown in the header (shows current organization name).

2

Select Organization

Choose a different organization from the dropdown list.

3

Data Refresh

All tabs automatically refresh to show data for the newly selected organization.

Note: All operations are scoped to the selected organization. API keys, webhooks, quotas, and workflow resources are organization-specific.

Managing Organization Name

You can edit the organization name from the Organization tab:

  1. Navigate to the "Organization" tab in the main dashboard
  2. View the current organization name
  3. Edit the name field
  4. Click "Save" to update

Note: The organization ID cannot be changed. Only the name is editable.

Quotas Management

Quotas define resource limits for your organization. These limits control how many resources you can create:

API Key Limit

Maximum number of API keys you can create

Definition Limit

Maximum number of workflow definitions

Execution Limit

Maximum number of workflow executions

Rate Limit

API rate limit (requests per time period)

Viewing Quotas

All users can view quotas from the "Quotas" tab in the main dashboard. The current limits are displayed for each quota type.

Editing Quotas

Quota editing is available based on your permissions:

  1. Navigate to the "Quotas" tab
  2. Edit the quota values (if you have permission)
  3. Changes are tracked and validated before save
  4. Click "Save" to apply changes
  5. Success or error messages are displayed

Note: Quota editing permissions are managed by your organization administrator.

Organization Scoping

All resources in yWorkflow are scoped to organizations:

  • API Keys: Created and managed per organization
  • Workflow Definitions: Stored per organization
  • Workflow Executions: Run within an organization context
  • Webhooks: Configured per organization
  • Quotas: Applied per organization

💡 Multi-Organization Workflow: If you belong to multiple organizations, you can manage completely separate sets of resources for each one. This is useful for separating different environments or projects.

Previous: Webhooks Next: API Reference