Build sessions
Edit a file
Replace an exact snippet in an existing file.
POST
/
sessions
/
{sessionId}
/
files
/
edit
Edit a file
curl --request POST \
--url https://api.zite.com/v1/sessions/{sessionId}/files/edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "apps/agent-console/src/App.tsx",
"oldText": "<h1>Old</h1>",
"newText": "<h1>New</h1>"
}
'import requests
url = "https://api.zite.com/v1/sessions/{sessionId}/files/edit"
payload = {
"path": "apps/agent-console/src/App.tsx",
"oldText": "<h1>Old</h1>",
"newText": "<h1>New</h1>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
path: 'apps/agent-console/src/App.tsx',
oldText: '<h1>Old</h1>',
newText: '<h1>New</h1>'
})
};
fetch('https://api.zite.com/v1/sessions/{sessionId}/files/edit', 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.zite.com/v1/sessions/{sessionId}/files/edit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'path' => 'apps/agent-console/src/App.tsx',
'oldText' => '<h1>Old</h1>',
'newText' => '<h1>New</h1>'
]),
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.zite.com/v1/sessions/{sessionId}/files/edit"
payload := strings.NewReader("{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.zite.com/v1/sessions/{sessionId}/files/edit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zite.com/v1/sessions/{sessionId}/files/edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}"
response = http.request(request)
puts response.read_body{
"path": "apps/agent-console/src/App.tsx",
"replaced": true
}{
"statusCode": 400,
"error": "Bad Request",
"message": "oldText matches 3 places in \"apps/agent-console/src/App.tsx\" - include more surrounding context to make it unique"
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "API authorization header missing"
}{
"statusCode": 404,
"error": "Not Found",
"message": "Workspace not found"
}Replaces
oldText with newText in a file.
files/edit replaces oldText where it occurs exactly once. If it matches zero or more than one
place, the call returns 400. Include more surrounding context so the match is unique. Use
Write a file for new files or full rewrites.Body
application/json
⌘I
Edit a file
curl --request POST \
--url https://api.zite.com/v1/sessions/{sessionId}/files/edit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "apps/agent-console/src/App.tsx",
"oldText": "<h1>Old</h1>",
"newText": "<h1>New</h1>"
}
'import requests
url = "https://api.zite.com/v1/sessions/{sessionId}/files/edit"
payload = {
"path": "apps/agent-console/src/App.tsx",
"oldText": "<h1>Old</h1>",
"newText": "<h1>New</h1>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
path: 'apps/agent-console/src/App.tsx',
oldText: '<h1>Old</h1>',
newText: '<h1>New</h1>'
})
};
fetch('https://api.zite.com/v1/sessions/{sessionId}/files/edit', 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.zite.com/v1/sessions/{sessionId}/files/edit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'path' => 'apps/agent-console/src/App.tsx',
'oldText' => '<h1>Old</h1>',
'newText' => '<h1>New</h1>'
]),
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.zite.com/v1/sessions/{sessionId}/files/edit"
payload := strings.NewReader("{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.zite.com/v1/sessions/{sessionId}/files/edit")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zite.com/v1/sessions/{sessionId}/files/edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"path\": \"apps/agent-console/src/App.tsx\",\n \"oldText\": \"<h1>Old</h1>\",\n \"newText\": \"<h1>New</h1>\"\n}"
response = http.request(request)
puts response.read_body{
"path": "apps/agent-console/src/App.tsx",
"replaced": true
}{
"statusCode": 400,
"error": "Bad Request",
"message": "oldText matches 3 places in \"apps/agent-console/src/App.tsx\" - include more surrounding context to make it unique"
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "API authorization header missing"
}{
"statusCode": 404,
"error": "Not Found",
"message": "Workspace not found"
}