Update Environment

curl --request PATCH \
  --url https://api.tryreplicas.com/v1/environments/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "system_prompt": "<string>",
  "mobile_testing_enabled": true,
  "personal_preferences": "<string>"
}
'

import requests

url = "https://api.tryreplicas.com/v1/environments/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "system_prompt": "<string>",
    "mobile_testing_enabled": True,
    "personal_preferences": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    repository_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    repository_set_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    system_prompt: '<string>',
    mobile_testing_enabled: true,
    personal_preferences: '<string>'
  })
};

fetch('https://api.tryreplicas.com/v1/environments/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tryreplicas.com/v1/environments/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'repository_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'repository_set_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'system_prompt' => '<string>',
    'mobile_testing_enabled' => true,
    'personal_preferences' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tryreplicas.com/v1/environments/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.tryreplicas.com/v1/environments/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tryreplicas.com/v1/environments/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "environment": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "is_global": true,
    "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "system_prompt": "<string>",
    "mobile_testing_enabled": true,
    "personal_preferences": "<string>",
    "source_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "variable_count": 123,
    "file_count": 123,
    "skill_count": 123,
    "mcp_count": 123
  }
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

Environments

Update Environment

Updates a non-global environment. Only provided fields are changed. PATCH /v1/environments/global returns 400 with a pointer to the nested resource endpoints (variables, files, skills, MCPs, warm hooks) — the Global env’s metadata cannot be edited directly. Source-backed personal environments cannot change repository_id, repository_set_id, or system_prompt, but may set personal_preferences, instructions appended after the inherited system prompt. Returns 409 when an automation still references the environment in a way that blocks the requested change.

PATCH

environments

{id}

Update Environment

curl --request PATCH \
  --url https://api.tryreplicas.com/v1/environments/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "system_prompt": "<string>",
  "mobile_testing_enabled": true,
  "personal_preferences": "<string>"
}
'

import requests

url = "https://api.tryreplicas.com/v1/environments/{id}"

payload = {
    "name": "<string>",
    "description": "<string>",
    "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "system_prompt": "<string>",
    "mobile_testing_enabled": True,
    "personal_preferences": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    repository_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    repository_set_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    system_prompt: '<string>',
    mobile_testing_enabled: true,
    personal_preferences: '<string>'
  })
};

fetch('https://api.tryreplicas.com/v1/environments/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tryreplicas.com/v1/environments/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'repository_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'repository_set_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'system_prompt' => '<string>',
    'mobile_testing_enabled' => true,
    'personal_preferences' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tryreplicas.com/v1/environments/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.tryreplicas.com/v1/environments/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tryreplicas.com/v1/environments/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"repository_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"repository_set_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"system_prompt\": \"<string>\",\n  \"mobile_testing_enabled\": true,\n  \"personal_preferences\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "environment": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "is_global": true,
    "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "system_prompt": "<string>",
    "mobile_testing_enabled": true,
    "personal_preferences": "<string>",
    "source_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "variable_count": 123,
    "file_count": 123,
    "skill_count": 123,
    "mcp_count": 123
  }
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. User-session JWTs are not accepted by /v1/replica endpoints.

Path Parameters

string

required

Environment UUID. The literal global is rejected with 400 — see endpoint description.

Body

application/json

Request body for updating an environment. Only provided fields are changed. repository_id and repository_set_id remain mutually exclusive when both are supplied.

name

string

description

string | null

repository_id

string<uuid> | null

repository_set_id

string<uuid> | null

system_prompt

string | null

mobile_testing_enabled

boolean

Enable or disable mobile testing. Only valid on team environments; enabling requires a trial, Team, or Enterprise plan and otherwise returns PLAN_UPGRADE_REQUIRED.

personal_preferences

string | null

Only settable on personal environments. Appended after the (inherited) system prompt.

Response

Environment updated

environment

object

required

An environment — the config bundle workspaces are created from. Holds an optional repository binding plus the runtime variables, files, skills, MCPs, and warm hook applied to every workspace built from it. Every organization has a singleton Global environment (is_global: true) whose values are layered onto every other environment. Personal environments have user_id set and are visible only to their owner. Source-backed personal environments expose source-derived repository binding and system prompt values while keeping the source link in source_environment_id.

Show child attributes

Replica

Presence

Credentials

Agents

Downloads

Media

Analytics

Environments

Repository

Automation

Google Search Console

Slack

Linear

Preview

Terminal

Profile

API Keys

Update Environment

Authorizations

Path Parameters

Body

Response