Saltar al contenido principal
POST
Reabrir un registro de pipeline cerrado

Autorizaciones

x-api-key
string
header
requerido

Copy the API key as provided by the Bridge Console.

Encabezados

Idempotency-Key
string
requerido

Una clave que eliges por cada cambio, como el id de operación de tu sistema. Envía la misma clave cuando reintentes la solicitud: durante 24 horas responde con el registro que cambió la primera solicitud.

Required string length: 1 - 255
Ejemplo:

"erp-opp-981-won"

Parámetros de ruta

workspaceId
string<uuid>
requerido

Identificador único del workspace (UUID v4).

Ejemplo:

"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"

recordId
string
requerido

Identificador único del registro de pipeline.

Required string length: 1 - 255
Ejemplo:

"0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11"

Cuerpo

application/json

Cuerpo de la solicitud para reabrir un registro de pipeline cerrado.

expectedRevision
integer | null

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.

Rango requerido: x >= 1
Ejemplo:

3

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.

id
string
requerido

Identificador único del registro.

Ejemplo:

"0d3c7f0e-5a43-5c0e-9f53-1f6a4b2e7d11"

pipelineId
string
requerido

Pipeline al que pertenece el registro.

Ejemplo:

"5d0b8f8e-3c1a-4a4e-9a57-2f6f3e1c9b10"

pipelineVersion
integer
requerido

Versión del pipeline que sigue el registro.

Ejemplo:

3

stageId
string
requerido

Etapa en la que está el registro.

Ejemplo:

"stage-new"

state
enum<string>
requerido

OPEN mientras el registro está en una etapa abierta, FINAL cuando está en una etapa final.

Opciones disponibles:
OPEN,
FINAL
Ejemplo:

"OPEN"

name
string
requerido

Nombre del registro.

Ejemplo:

"Acme renewal 2027"

contact
Contact · object
requerido

El contacto al que pertenece el registro.

source
enum<string>
requerido

Cómo se creó el registro: API, ADVISOR, INBOUND_SESSION o FROM_PIPELINE.

Opciones disponibles:
ADVISOR,
API,
INBOUND_SESSION,
FROM_PIPELINE
Ejemplo:

"API"

revision
integer
requerido

Aumenta en uno cada vez que el registro cambia.

Ejemplo:

1

createdAt
string
requerido

Cuándo se creó el registro.

Ejemplo:

"2026-11-11T15:00:00.000Z"

updatedAt
string
requerido

Cuándo cambió el registro por última vez.

Ejemplo:

"2026-11-11T15:00:00.000Z"

values
Values · object

Valores de los atributos del registro, indexados por id de atributo.

Ejemplo:
ownerId
string | null

Id del Usuario de Bridge propietario del registro. Resuélvelo con GET /users/{userId}.

Ejemplo:

null

externalId
string | null

El id del registro en tu sistema, cuando se creó con uno.

Ejemplo:

"ERP-OPP-981"

closeReason
RecordCloseReasonResponse · object | null

El motivo con el que se cerró un registro cerrado.

closedAt
string | null

Cuándo el registro llegó a una etapa final; null mientras está abierto.

Ejemplo:

null