Skip to main content
PATCH
https://service.thatsme.com.br
/
api
/
v1.0
/
events
/
{id}
Atualizar Evento
curl --request PATCH \
  --url https://service.thatsme.com.br/api/v1.0/events/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "location_type": "<string>",
  "city": "<string>",
  "state": "<string>",
  "category": "<string>",
  "initial_date": "<string>",
  "finish_date": "<string>",
  "official_url": "<string>",
  "image_url": "<string>",
  "image_key": "<string>",
  "is_private": true,
  "date_mode": "<string>",
  "start_time": "<string>",
  "end_time": "<string>",
  "recurrence_type": "<string>",
  "recurrence_start_date": "<string>",
  "connected_event_ids": [
    {}
  ]
}
'
{
  "event_id": "event_123",
  "name": "Workshop de Tecnologia Atualizado",
  "description": "Workshop sobre desenvolvimento web atualizado",
  "category": "EDUCATION",
  "subcategory": "Oficina ou Workshop",
  "location_type": "physical",
  "city": "São Paulo",
  "state": "SP",
  "initial_date": "2024-03-15T09:00:00Z",
  "finish_date": "2024-03-15T18:00:00Z",
  "official_url": "https://evento.com.br",
  "image_url": "https://example.com/event.png",
  "status": "PENDING",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T14:45:00Z"
}
Atualiza um evento existente do próprio emissor autenticado. Todos os campos do corpo são opcionais, mas as mesmas validações da criação se aplicam.
Envie apenas os campos que deseja alterar.
Para consultar o evento completo após a atualização, use GET /api/v1.0/events/{id}.
Eventos com status FINISHED não podem ser modificados.Qualquer tentativa de atualização em um evento finalizado resultará em erro.

Parâmetros de rota

id
string
required
ID do evento a ser atualizado (event_id).

Parâmetros do corpo (body)

name
string
Nome do evento.
description
string
Descrição do evento.
location_type
string
Tipo de localização do evento. Valores aceitos: online ou physical.Regras:
  • online: city e state são definidos como ONLINE
  • physical: city e state tornam-se obrigatórios
city
string
Cidade do evento (obrigatório quando location_type for physical).
state
string
Estado (UF) do evento (obrigatório quando location_type for physical).Valores aceitos: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.
category
string
Categoria do evento. Valores aceitos: SPORTS, EDUCATION, CORPORATE, SOCIOCULTURAL.
initial_date
string
Data e hora de início (ISO 8601).
finish_date
string
Data e hora de término (ISO 8601).
official_url
string
URL oficial do evento.
image_url
string
URL pública da imagem do evento (opcional).
image_key
string
Identificador da imagem no storage da That’s Me (ex.: S3) (opcional).
is_private
boolean
Define se o evento é privado.
date_mode
string
Modo de datas do evento. Valores aceitos: single_date, date_range, recurring, always_available.Regras:
  • always_available: datas podem ser omitidas
  • single_date e date_range: datas devem ser informadas conforme aplicável
  • recurring: exige recurrence_type e recurrence_start_date
start_time
string
Horário de início (quando aplicável).
end_time
string
Horário de término (quando aplicável).
recurrence_type
string
Tipo de recorrência (quando date_mode for recurring).
Valores aceitos: WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL.
recurrence_start_date
string
Data de início da recorrência (ISO 8601) (quando date_mode for recurring).
connected_event_ids
array
Lista de IDs de eventos conectados.
Eventos conectados podem ser utilizados pelo motor de recomendações para sugerir próximos eventos após a emissão de certificados.
Campos condicionais (ex.: location_type, date_mode) devem respeitar as regras descritas acima para evitar erro de validação.

Resposta

event_id
string
ID do evento atualizado.
name
string
Nome do evento.
description
string
Descrição do evento.
category
string
Categoria do evento.
subcategory
string
Subcategoria do evento.
location_type
string
Tipo de localização do evento.
city
string
Cidade do evento.
state
string
Estado (UF).
initial_date
string
Data e hora de início (ISO 8601).
finish_date
string
Data e hora de término (ISO 8601).
official_url
string
URL oficial do evento.
image_url
string
URL da imagem do evento.
status
string
Status do evento.
created_at
string
Data e hora de criação (ISO 8601).
updated_at
string
Data e hora de atualização (ISO 8601).

Exemplo de resposta

{
  "event_id": "event_123",
  "name": "Workshop de Tecnologia Atualizado",
  "description": "Workshop sobre desenvolvimento web atualizado",
  "category": "EDUCATION",
  "subcategory": "Oficina ou Workshop",
  "location_type": "physical",
  "city": "São Paulo",
  "state": "SP",
  "initial_date": "2024-03-15T09:00:00Z",
  "finish_date": "2024-03-15T18:00:00Z",
  "official_url": "https://evento.com.br",
  "image_url": "https://example.com/event.png",
  "status": "PENDING",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T14:45:00Z"
}

Erros comuns

{
  "error": "EVENT_ALREADY_FINISHED",
  "message": "Eventos com status FINISHED não podem ser modificados."
}