Apply code edit

Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content.

To use this endpoint as an agent tool, follow these guidelines:

Use this tool to make an edit to an existing file. This will be read by a less intelligent model, which will quickly apply the edit. You should make it clear what the edit is, while also minimizing the unchanged code you write.

When writing the edit, you should specify each edit in sequence, with the special comment ”// … existing code …” to represent unchanged code in between edited lines.

Example format: // … existing code … FIRST_EDIT // … existing code … SECOND_EDIT // … existing code … THIRD_EDIT // … existing code …

You should still bias towards repeating as few lines of the original file as possible to convey the change. But, each edit should contain minimally sufficient context of unchanged lines around the code you’re editing to resolve ambiguity.

DO NOT omit spans of pre-existing code (or comments) without using the ”// … existing code …” comment to indicate its absence. If you omit the existing code comment, the model may inadvertently delete these lines.

If you plan on deleting a section, you must provide context before and after to delete it. If the initial code is “Block 1\nBlock 2\nBlock 3”, and you want to remove Block 2, you would output ”// … existing code …\nBlock 1\nBlock 3\n// … existing code …”.

Make sure it is clear what the edit should be, and where it should be applied. Make edits to a file in a single edit_file call instead of multiple edit_file calls to the same file. The apply model can handle many distinct edits at once.

PUT /codegen/fastapply/{path}

Apply code edit

cURL

curl --request PUT \
  --url https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "codeEdit": "// Add world parameter\nfunction hello(world) {\n  console.log('Hello', world);\n}",
  "model": "auto"
}
EOF

import requests

url = "https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}"

payload = {
    "codeEdit": "// Add world parameter
function hello(world) {
  console.log('Hello', world);
}",
    "model": "auto"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    codeEdit: '// Add world parameter\nfunction hello(world) {\n  console.log(\'Hello\', world);\n}',
    model: 'auto'
  })
};

fetch('https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}', 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://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'codeEdit' => '// Add world parameter
function hello(world) {
  console.log(\'Hello\', world);
}',
    'model' => 'auto'
  ]),
  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://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}"

	payload := strings.NewReader("{\n  \"codeEdit\": \"// Add world parameter\\nfunction hello(world) {\\n  console.log('Hello', world);\\n}\",\n  \"model\": \"auto\"\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"codeEdit\": \"// Add world parameter\\nfunction hello(world) {\\n  console.log('Hello', world);\\n}\",\n  \"model\": \"auto\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sbx-{sandbox_id}-{workspace_id}.{region}.bl.run/codegen/fastapply/{path}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"codeEdit\": \"// Add world parameter\\nfunction hello(world) {\\n  console.log('Hello', world);\\n}\",\n  \"model\": \"auto\"\n}"

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

200

{
  "message": "Code edit applied successfully",
  "originalContent": "function hello() {\n  console.log('Hello');\n}",
  "path": "src/main.js",
  "provider": "Relace",
  "success": true,
  "updatedContent": "function hello(world) {\n  console.log('Hello', world);\n}"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

{
  "error": "Error message"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

path · string · required

Path to the file to edit (relative to workspace)

Body

application/json

Code edit request

codeEdit · string · required

Example:

"// Add world parameter\nfunction hello(world) {\n console.log('Hello', world);\n}"

model · string

Example:

"auto"

Response

200

application/json

Code edit applied successfully

message · string

Example:

"Code edit applied successfully"

originalContent · string

Example:

"function hello() {\n console.log('Hello');\n}"

path · string

Example:

"src/main.js"

provider · string

Example:

"Relace"

success · boolean

Example:

true

updatedContent · string

Example:

"function hello(world) {\n console.log('Hello', world);\n}"