Skip to main content
PATCH
Actualizar un ticket

Authorizations

Authorization
string
header
required

La API key de tu organización, con la forma rvm_<prefijo>.<secreto>, enviada como Authorization: Bearer rvm_…. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera.

Path Parameters

id
string<uuid>
required

Id del ticket.

Body

application/json

Todos los campos son opcionales, pero el cuerpo debe traer al menos uno.

title
string

Título del ticket.

Minimum string length: 1
funnelStageId
integer

Etapa del embudo. Debe pertenecer al tenant.

status
enum<string>

active, won o lost. No se acepta postponed: posponer programa una reapertura y sólo se hace desde la app.

Available options:
active,
won,
lost
assignedToProfileId
string<uuid> | null

Perfil a asignar, o null para desasignar.

pointOfContact
string<uuid> | null

Id de contacto, o null para desvincular.

account
string<uuid> | null

Id de contacto que actúa como cuenta, o null para desvincular.

lossReason
string | null

Motivo de pérdida. Suele acompañar a status: "lost".

customAttributes
object

Atributos personalizados del ticket, por id de definición. Reemplaza el conjunto completo.

Response

El ticket actualizado.

id
string<uuid>
required
title
string
required
status
enum<string>
required

active, postponed, won o lost. postponed sólo se alcanza desde la app; la API no puede posponer.

Available options:
active,
postponed,
won,
lost
funnelStageId
integer
required

Etapa del embudo en que está el ticket.

funnelId
string<uuid>
required

Embudo al que pertenece la etapa. Derivado, no editable.

assignedToProfileId
string<uuid> | null
required

Perfil del equipo asignado, o null.

createdByProfileId
string<uuid> | null
required
pointOfContact
string<uuid> | null
required

Contacto principal del ticket (un id de contacto), o null.

account
string<uuid> | null
required

Contacto que actúa como cuenta u organización, o null.

customAttributes
object
required

Atributos personalizados del ticket, identificados por el id de su definición.

lossReason
string | null
required

Motivo de pérdida cuando status es lost.

visibility
enum<string>
required

Modelo de visibilidad para las personas del equipo. Una API key ve todos los tickets del tenant sin importar este valor.

Available options:
OWNER,
OWNER_AND_GROUPS,
TENANT
visibilityGroupId
string<uuid> | null
required
postponedUntil
string<date-time> | null
required

Fecha de reapertura cuando el ticket está pospuesto.

closedAt
string<date-time> | null
required

Fecha de cierre cuando status es won o lost.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
conversations
object[]
required

Conversaciones enlazadas al ticket. Puede haber más de una.