curl --request PATCH \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"expectedRevision": 3,
"name": "Acme renewal 2027 - expanded",
"values": {
"budget": 18000000
}
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}"
payload = {
"expectedRevision": 3,
"name": "Acme renewal 2027 - expanded",
"values": { "budget": 18000000 }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 3,
name: 'Acme renewal 2027 - expanded',
values: {budget: 18000000}
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}', 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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}",
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([
'expectedRevision' => 3,
'name' => 'Acme renewal 2027 - expanded',
'values' => [
'budget' => 18000000
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}"
payload := strings.NewReader("{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11",
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"pipelineVersion": 3,
"stageId": "stage-new",
"state": "OPEN",
"name": "Acme renewal 2027",
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8"
},
"source": "API",
"revision": 1,
"createdAt": "2026-11-11T15:00:00.000Z",
"updatedAt": "2026-11-11T15:00:00.000Z",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15"
},
"ownerId": null,
"externalId": "ERP-OPP-981",
"closeReason": {
"id": "reason-price",
"label": "Price too high",
"note": null
},
"closedAt": null
}Actualizar un registro de pipeline
Cambia el nombre o algunos valores de un registro, abierto o cerrado.
Solo cambian los campos enviados: un name ausente conserva el nombre, y los atributos omitidos de values conservan su
valor; un null, un texto vacío o una lista vacía elimina un valor. Un registro siempre tiene nombre, por lo que un name
null o vacío falla como cualquier otro campo inválido. Cada problema encontrado se lista en extra.errors del 422
BRIDGE_PIPELINE_0311, que también es la respuesta a un cuerpo que no cambia nada. Un cambio que deja el registro
tal como está no escribe nada y responde el registro. Con expectedRevision, un registro modificado desde que lo leíste falla
con 409 BRIDGE_PIPELINE_0101, cuyo extra.currentRecord es el registro tal como está ahora.
curl --request PATCH \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"expectedRevision": 3,
"name": "Acme renewal 2027 - expanded",
"values": {
"budget": 18000000
}
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}"
payload = {
"expectedRevision": 3,
"name": "Acme renewal 2027 - expanded",
"values": { "budget": 18000000 }
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: 3,
name: 'Acme renewal 2027 - expanded',
values: {budget: 18000000}
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}', 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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}",
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([
'expectedRevision' => 3,
'name' => 'Acme renewal 2027 - expanded',
'values' => [
'budget' => 18000000
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}"
payload := strings.NewReader("{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expectedRevision\": 3,\n \"name\": \"Acme renewal 2027 - expanded\",\n \"values\": {\n \"budget\": 18000000\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11",
"pipelineId": "5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10",
"pipelineVersion": 3,
"stageId": "stage-new",
"state": "OPEN",
"name": "Acme renewal 2027",
"contact": {
"id": "4e362e2b-67b2-4a7e-a9df-e9ecf9141be8"
},
"source": "API",
"revision": 1,
"createdAt": "2026-11-11T15:00:00.000Z",
"updatedAt": "2026-11-11T15:00:00.000Z",
"values": {
"budget": 15000000,
"closeDate": "2026-12-15"
},
"ownerId": null,
"externalId": "ERP-OPP-981",
"closeReason": {
"id": "reason-price",
"label": "Price too high",
"note": null
},
"closedAt": null
}Parámetros de ruta
Cuerpo
Cuerpo de la solicitud para cambiar el nombre o algunos valores de un registro de pipeline.
La revision del registro que leíste por última vez. Cuando ya no es la actual, el cambio falla con 409 BRIDGE_PIPELINE_0101 y el registro actual en extra.currentRecord. Sin ella, el cambio se aplica al registro tal como lo lee la solicitud, por lo que otro cambio hecho en el mismo instante aún puede hacerla fallar con ese 409.
x >= 13
Valores a cambiar, indexados por id de atributo; los atributos omitidos conservan su valor. Un null, un texto vacío o una lista vacía elimina el valor. Solo se aceptan atributos de alcance RECORD de la versión que sigue el registro, cada uno validado según su tipo.
{ "budget": 18000000 }
Respuesta
Respuesta satisfactoria
Un registro de un pipeline, como una oportunidad de venta de un contacto.
¿Esta página le ayudó?

