variable_copy
Copy environment variables between Railway environments for migration, configuration sharing, or duplication workflows.
Instructions
[WORKFLOW] Copy variables from one environment to another
⚡️ Best for: ✓ Environment migration ✓ Configuration sharing ✓ Environment duplication
⚠️ Not for: × Single variable updates (use variable_set) × Temporary configuration changes
→ Prerequisites: service_list
→ Alternatives: variable_set
→ Next steps: deployment_trigger, service_restart
→ Related: variable_list, service_update
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | ID of the project | |
| sourceEnvironmentId | Yes | ID of the source environment (usually obtained from project_info) | |
| targetEnvironmentId | Yes | ID of the target environment (usually obtained from project_info) | |
| serviceId | No | ID of the service (optional, if omitted copies shared variables) | |
| overwrite | No | Whether to overwrite existing variables in the target environment |
Implementation Reference
- src/services/variable.service.ts:95-135 (handler)Core handler implementing variable copy logic: fetches source and target variables, applies overwrite filter, performs bulk upsert.async copyVariables(projectId: string, sourceEnvironmentId: string, targetEnvironmentId: string, serviceId?: string, overwrite: boolean = false) { try { // Get variables from source environment const sourceVars = await this.client.variables.getVariables(projectId, sourceEnvironmentId, serviceId); if (Object.keys(sourceVars).length === 0) { return createSuccessResponse({ text: "No variables found in source environment to copy.", data: { copied: 0 } }); } // Get variables from target environment const targetVars = await this.client.variables.getVariables(projectId, targetEnvironmentId, serviceId); // If not overwriting, filter out variables that already exist in target const varsToSet = overwrite ? sourceVars : Object.fromEntries( Object.entries(sourceVars).filter(([key]) => !(key in targetVars)) ); if (Object.keys(varsToSet).length === 0) { return createSuccessResponse({ text: "All variables already exist in target environment.", data: { copied: 0 } }); } // Bulk update the variables await this.bulkUpsertVariables(projectId, targetEnvironmentId, varsToSet, serviceId); const variableType = serviceId ? "service variables" : "shared environment variables"; return createSuccessResponse({ text: `Successfully copied ${Object.keys(varsToSet).length} ${variableType} to target environment`, data: { copied: Object.keys(varsToSet).length } }); } catch (error) { return createErrorResponse(`Error copying variables: ${formatError(error)}`); } }
- src/tools/variable.tool.ts:130-161 (registration)Tool registration via createTool, defining name, description, input schema with Zod, and thin handler delegating to service.createTool( "variable_copy", formatToolDescription({ type: 'WORKFLOW', description: "Copy variables from one environment to another", bestFor: [ "Environment migration", "Configuration sharing", "Environment duplication" ], notFor: [ "Single variable updates (use variable_set)", "Temporary configuration changes" ], relations: { prerequisites: ["service_list"], nextSteps: ["deployment_trigger", "service_restart"], alternatives: ["variable_set"], related: ["variable_list", "service_update"] } }), { projectId: z.string().describe("ID of the project"), sourceEnvironmentId: z.string().describe("ID of the source environment (usually obtained from project_info)"), targetEnvironmentId: z.string().describe("ID of the target environment (usually obtained from project_info)"), serviceId: z.string().optional().describe("ID of the service (optional, if omitted copies shared variables)"), overwrite: z.boolean().optional().default(false).describe("Whether to overwrite existing variables in the target environment") }, async ({ projectId, sourceEnvironmentId, targetEnvironmentId, serviceId, overwrite = false }) => { return variableService.copyVariables(projectId, sourceEnvironmentId, targetEnvironmentId, serviceId, overwrite); } )
- Helper method for bulk upserting variables, used internally by copyVariables to update the target environment.async bulkUpsertVariables(projectId: string, environmentId: string, variables: Record<string, string>, serviceId?: string) { try { const inputs = Object.entries(variables).map(([name, value]) => ({ projectId, environmentId, name, value, serviceId })); await this.client.variables.upsertVariables(inputs); const variableType = serviceId ? "service variables" : "shared environment variables"; return createSuccessResponse({ text: `Successfully updated ${inputs.length} ${variableType}` }); } catch (error) { return createErrorResponse(`Error updating variables: ${formatError(error)}`); } }