/**
 * @example
 *     {
 *         name: "Invoice #12345",
 *         metadata: {
 *             "customerId": "cust_abc123",
 *             "source": "email-inbox"
 *         }
 *     }
 */
export interface WorkflowRunsUpdateRequest {
    /** The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/developers/authentication) for details on API key scopes. */
    "x-extend-workspace-id"?: string;
    /** An optional name that can be assigned to a specific WorkflowRun */
    name?: string;
    /**
     * A metadata object that can be assigned to a specific WorkflowRun. If metadata already exists on this WorkflowRun, the newly incoming metadata will be merged with the existing metadata, with the incoming metadata taking field precedence.
     *
     * You can include any arbitrary `key : value` pairs in this object.
     *
     * To categorize workflow runs for billing and usage tracking, include `extend:usage_tags` with an array of string values (e.g., `{"extend:usage_tags": ["production", "team-eng", "customer-123"]}`). Tags must contain only alphanumeric characters, hyphens, and underscores; any special characters will be automatically removed.
     */
    metadata?: Record<string, unknown>;
}