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 organización del tenant 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 nombre. Acepta las claves exactas devueltas por GET (incluidas las claves antiguas), ids de definición existentes y nombres sin distinguir mayúsculas cuando no son ambiguos. Claves nuevas desconocidas, ambiguas o dos claves que apuntan al mismo atributo devuelven 400. 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

ID de organización vinculada como cuenta, o null. Se consulta mediante GET /organizations/public/v1/{id}.

customAttributes
object
required

Atributos personalizados del ticket, identificados por el nombre actual de su definición. Las claves sin un id de definición coincidente se conservan. Si un nombre colisiona con otra clave almacenada o un id de definición, se conserva el id original para no perder valores.

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.