Skip to main content
PATCH
/
events
/
{event}
Atualizar evento
curl --request PATCH \
  --url http://localhost/api/v1/events/{event} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "date": "2023-12-25",
  "city": "<string>",
  "state": "<string>",
  "document": "<string>",
  "organizer_id": 123,
  "hub_unit_id": 123,
  "salesperson_person_id": 123,
  "expected_athletes": 500000,
  "bib_count": 1,
  "tag_count": 1,
  "paid_tag_base_count": 1,
  "difficulty_grade": "<string>",
  "technical_description": "<string>",
  "commercial_description": "<string>",
  "regulation": "<string>",
  "regulation_acceptance_required": true,
  "regulation_extra_text": "<string>",
  "has_cronoself": true,
  "has_qrcode_list": true,
  "has_medrace": true,
  "registration_support_whatsapp": "<string>",
  "certificate_enabled": true,
  "hub_fee_percent": 50,
  "service_fee_cents": 1,
  "refund_window_days": 182,
  "refund_summary": "<string>"
}
'
{
  "data": {
    "id": 123,
    "code": "<string>",
    "name": "<string>",
    "status": "<string>",
    "date": "<string>",
    "city": "<string>",
    "state": "<string>",
    "document": "<string>",
    "organizer_id": 123,
    "hub_unit_id": 123,
    "salesperson_person_id": 123,
    "expected_athletes": 123,
    "bib_count": 123,
    "tag_count": 123,
    "paid_tag_base_count": 123,
    "difficulty_grade": "<string>",
    "technical_description": "<string>",
    "commercial_description": "<string>",
    "regulation": "<string>",
    "regulation_acceptance_required": true,
    "regulation_extra_text": "<string>",
    "has_cronoself": true,
    "has_qrcode_list": true,
    "has_medrace": true,
    "registration_support_whatsapp": "<string>",
    "certificate_enabled": true,
    "sales_mode": "<string>",
    "external_registration_url": "<string>",
    "is_free": true,
    "registration_open": true,
    "registration_opens_at": "<string>",
    "registration_closes_at": "<string>",
    "max_registrations": 123,
    "hub_fee_percent": "<string>",
    "service_fee_cents": 123,
    "service_fee_mode": "<string>",
    "refund_window_days": 123,
    "refund_summary": "<string>",
    "logo_url": "<string>",
    "banner_url": "<string>",
    "regulation_pdf_url": "<string>",
    "pipeline_stage_id": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "organizer": {
      "id": 123,
      "name": "<string>"
    },
    "races": [
      {
        "id": 123,
        "event_id": 123,
        "code": "<string>",
        "name": "<string>",
        "distance": 123,
        "distance_label": "<string>",
        "sort_order": 123,
        "starts_at": "<string>",
        "type": "<string>",
        "scoring_type": "<string>",
        "duration_minutes": 123,
        "lap_count": 123,
        "lap_distance": 123,
        "registration_limit": 123,
        "sem_classificacao": true,
        "status": "<string>",
        "results_status": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "modalities": [
          {
            "id": 123,
            "name": "<string>",
            "is_default": true
          }
        ],
        "categories": [
          {
            "id": 123,
            "race_id": 123,
            "event_id": 123,
            "name": "<string>",
            "type": "<string>",
            "modality_id": 123,
            "category_group_id": "<string>",
            "sex": "<string>",
            "age_min": 123,
            "age_max": 123,
            "award_count": 123,
            "is_pwd": true,
            "is_team": true,
            "sort_order": 123,
            "status": "<string>",
            "created_at": "<string>",
            "updated_at": "<string>",
            "modality": {
              "id": 123,
              "name": "<string>"
            }
          }
        ],
        "prize_rules": [
          {
            "id": 123,
            "race_id": 123,
            "event_id": 123,
            "seq": 123,
            "modality_id": 123,
            "ranking_type": "<string>",
            "ranking_cut": 123,
            "gender_filter": "<string>",
            "pne_filter": "<string>",
            "dupla_prem": [
              "<unknown>"
            ],
            "tipo_premiacao": "<string>",
            "eqp_apuracao": "<string>",
            "eqp_n_melhores": 123,
            "eqp_base_ranking": "<string>",
            "status": "<string>",
            "created_at": "<string>",
            "updated_at": "<string>",
            "modality": {
              "id": 123,
              "name": "<string>"
            }
          }
        ],
        "categories_count": "<string>"
      }
    ],
    "batches": [
      {
        "id": 123,
        "event_id": 123,
        "name": "<string>",
        "starts_at": "<string>",
        "ends_at": "<string>",
        "includes_kit": true,
        "max_quantity": 123,
        "quantity_sold": 123,
        "quantity_reserved": 123,
        "is_active": true,
        "installments_enabled": true,
        "max_installments": 123,
        "absorb_installment_interest": true,
        "sort_order": 123,
        "race_prices": [
          "<unknown>"
        ],
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "counters": {
      "registrations": "<string>",
      "results": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key do hub com escopo manage. Header: Authorization: Bearer <api_key>.

Path Parameters

​
event
string
required

Body

application/json

PATCH /api/v1/events/{event} — atualização parcial (preserve-on-absent). Expõe os ~25 campos que a Ingest API ignora. Todos opcionais (sometimes).

​
name
string
Maximum string length: 100
​
date
string<date> | null
​
city
string | null
Maximum string length: 100
​
state
string | null
Required string length: 2
​
document
string | null
Maximum string length: 15
​
organizer_id
integer | null
​
hub_unit_id
integer | null
​
salesperson_person_id
integer | null
​
expected_athletes
integer | null
Required range: 1 <= x <= 999999
​
bib_count
integer
Required range: x >= 0
​
tag_count
integer
Required range: x >= 0
​
paid_tag_base_count
integer
Required range: x >= 0
​
difficulty_grade
string | null
Maximum string length: 3
​
technical_description
string | null
Maximum string length: 1000
​
commercial_description
string | null
Maximum string length: 1000
​
regulation
string | null
​
regulation_acceptance_required
boolean
​
regulation_extra_text
string | null
​
has_cronoself
boolean
​
has_qrcode_list
boolean
​
has_medrace
boolean
​
registration_support_whatsapp
string | null
Maximum string length: 20
​
certificate_enabled
boolean
​
hub_fee_percent
number | null
Required range: 0 <= x <= 100
​
service_fee_cents
integer
Required range: x >= 0
​
service_fee_mode
enum<string>

Como a taxa de serviço (valor fixo por inscrição) do Hub é cobrada (Fase 02 Parte 05). embedded → sai do ingresso (organizador recebe menos; atleta não paga a mais); passed → repassada ao atleta (paga por cima; organizador não absorve a taxa fixa). Decisão 2026-06-01: no modo passed só a TAXA FIXA é repassada — o hub_fee_percent sempre sai do ingresso (organizador recebe ticket × (1 − hub_fee%)).

Available options:
embedded,
passed
​
refund_window_days
integer | null
Required range: 0 <= x <= 365
​
refund_summary
string | null
Maximum string length: 1000

Response

JsonResource

​
data
EventResource · object
required