curl --request POST \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"stageId": "stage-won",
"expectedRevision": 3,
"reasonId": "reason-price",
"reasonNote": "Chose a cheaper provider"
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move"
payload = {
"stageId": "stage-won",
"expectedRevision": 3,
"reasonId": "reason-price",
"reasonNote": "Chose a cheaper provider"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
stageId: 'stage-won',
expectedRevision: 3,
reasonId: 'reason-price',
reasonNote: 'Chose a cheaper provider'
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move', 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}/move",
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([
'stageId' => 'stage-won',
'expectedRevision' => 3,
'reasonId' => 'reason-price',
'reasonNote' => 'Chose a cheaper provider'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"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}/move"
payload := strings.NewReader("{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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.post("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\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
}Mover un registro de pipeline a otra etapa
Mueve un registro abierto a otra etapa de la versión del pipeline que sigue; una etapa final lo cierra.
Una etapa que no está en esa versión, como una de otro pipeline, falla con 422 BRIDGE_PIPELINE_0311
(errRecordStage), y la etapa en la que el registro ya está, con 409 BRIDGE_PIPELINE_0004. Un registro cerrado
falla con 409 BRIDGE_PIPELINE_0306: reábrelo primero. Cuando la etapa exige un contacto completo, uno
incompleto falla con 422 BRIDGE_PIPELINE_0305. Un movimiento a una etapa final puede llevar un reasonId activo
del pipeline (422 BRIDGE_PIPELINE_0315 cuando no existe, BRIDGE_PIPELINE_0314 cuando está retirado)
y un reasonNote; sin uno, el registro se cierra sin motivo. Un motivo o una nota en un movimiento a una etapa
abierta falla con 422 BRIDGE_PIPELINE_0311. 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.
Idempotency-Key es obligatorio y funciona como en POST /records: un reintento con la misma clave y el mismo cuerpo responde
con el registro y Idempotent-Replayed: true, tal como está ahora. La misma clave en otro registro u operación falla con
422 BRIDGE_PIPELINE_0402.
curl --request POST \
--url https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"stageId": "stage-won",
"expectedRevision": 3,
"reasonId": "reason-price",
"reasonNote": "Chose a cheaper provider"
}
'import requests
url = "https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move"
payload = {
"stageId": "stage-won",
"expectedRevision": 3,
"reasonId": "reason-price",
"reasonNote": "Chose a cheaper provider"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
stageId: 'stage-won',
expectedRevision: 3,
reasonId: 'reason-price',
reasonNote: 'Chose a cheaper provider'
})
};
fetch('https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move', 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}/move",
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([
'stageId' => 'stage-won',
'expectedRevision' => 3,
'reasonId' => 'reason-price',
'reasonNote' => 'Chose a cheaper provider'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"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}/move"
payload := strings.NewReader("{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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.post("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move")
.header("Idempotency-Key", "<idempotency-key>")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-connect-us.bridge.new/bridge/api/v1/workspaces/{workspaceId}/records/{recordId}/move")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"stageId\": \"stage-won\",\n \"expectedRevision\": 3,\n \"reasonId\": \"reason-price\",\n \"reasonNote\": \"Chose a cheaper provider\"\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
}Encabezados
Parámetros de ruta
Cuerpo
Cuerpo de la solicitud para mover un registro de pipeline a otra etapa de su 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
Respuesta
El registro tal como queda después del cambio, o después de una solicitud anterior con la misma clave.
Un registro de un pipeline, como una oportunidad de venta de un contacto.
¿Esta página le ayudó?

