Skip to main content
PATCH
/
events
/
{event}
/
races
/
{race}
Atualizar prova
curl --request PATCH \
  --url http://localhost/api/v1/events/{event}/races/{race} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "default_modality_id": 123,
  "distance": 1,
  "distance_label": "<string>",
  "sort_order": 123,
  "starts_at": "2023-11-07T05:31:56Z",
  "type": "<string>",
  "scoring_type": "<string>",
  "duration_minutes": 123,
  "lap_count": 123,
  "lap_distance": 1,
  "registration_limit": 123,
  "sem_classificacao": true,
  "modality_ids": [
    123
  ]
}
'
{
  "data": {
    "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>"
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
event
string
required
​
race
integer
required

Body

application/json

PATCH /api/v1/events/{event}/races/{race} — atualização parcial da prova.

​
name
string
Maximum string length: 80
​
default_modality_id
integer | null
​
distance
number | null
Required range: x >= 0
​
distance_label
string | null
Maximum string length: 20
​
sort_order
integer | null
​
starts_at
string<date-time> | null
​
type
string | null
Maximum string length: 20
​
scoring_type
string
Maximum string length: 20
​
duration_minutes
integer | null
​
lap_count
integer | null
​
lap_distance
number | null
Required range: x >= 0
​
registration_limit
integer | null
​
status
enum<string>

Status genérico usado por várias entidades (Hub, User, Group, Category, etc.). Entidades com estados específicos (Event, Registration) têm enums próprios.

Available options:
active,
inactive,
suspended
​
sem_classificacao
boolean

Prova sem cronometragem (ex.: KIDS) — portal exibe lista de inscritos.

​
results_status
enum<string>

Status de publicação do resultado de uma prova (race) como um todo. Provisório → resultado publicado, mas ainda sujeito a recurso/correção. Homologado → resultado oficial, chancelado pelo hub. O status NUNCA muda por import (decisão do Marcos, 2026-06-12): só por ação explícita na UI do hub ou via API (integrations /results-status e v1 PATCH race).

Available options:
provisional,
homologated
​
modality_ids
integer[]

Conjunto de modalidades da prova (sync race_modalities). Remoção é guardada: modalidade com inscrições/resultados → 409.

Response

JsonResource

​
data
RaceResource · object
required