Edit race series participant's info.
race_series_participant_idfirst_namelast_nameuser_defined_idgenderdobageemailphoneaddress1citystatezipcodecountrycodeThe request must include all required columns. Optional columns can be included or omitted as needed. Any columns not in the required or optional lists will result in an error.
Note: This endpoint only allows OAuth 2.0 authentication and requires the user to be a director of the race series or a timer of a race that is included in the series. It is currently in beta and subject to change.
{
"columns": [
"race_series_participant_id",
"user_defined_id",
"first_name",
"last_name",
"gender",
"dob",
"age",
"email",
"phone",
"address1",
"city",
"state",
"zipcode",
"countrycode"
],
"participants": [
[3861, null, "Dolores", "Nguyen", "F", "1981-06-25", 40, "dolores.nguyen@example.com", "856-655-7878", "1899 Saddle Dr", "Moorestown", "NJ", "08057", "US"],
[3862, null, "John", "Smith", "M", "1979-04-12", 45, "michael.smith@example.com", "415-555-1234", "1234 Pine St", "San Francisco", "CA", "94107", "US"]
]
}
{
"race_series_participants": [
{
"row": 1,
"race_series_participant_id": 3861
},
{
"row": 2,
"race_series_participant_id": 3862
},
]
}
| Parameter | HTTP Method | Default | Description | Datatype |
|---|---|---|---|---|
AuthorizationRequired |
HTTP Header | OAuth 2.0 Authorization header (e.g. `Bearer ...`). | string |
|
race_series_idRequired |
GET | Race series ID. | uint |
|
race_series_year_idRequired |
GET | Race series year ID. | uint |
|
race_idRequired |
GET | Race ID. | uint |
|
event_idRequired |
GET | Event ID. | uint |
|
requestRequired |
POST | JSON containing the participants that will be uploaded. | string |
{
"openapi": "3.0.3",
"info": {
"title": "Edit Race Series Participants (BETA)",
"description": "Edit series participants.",
"version": "1.0.0",
"contact": {
"name": "RunSignup API Support",
"url": "https://runsignup.com/API",
"email": "info@runsignup.com"
}
},
"servers": [
{
"url": "https://api.runsignup.com/rest",
"description": "Production API Server"
}
],
"tags": [
{
"name": "Race Series Scoring",
"description": "APIs related to Race Series Scoring"
}
],
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
},
"details": {
"type": "object",
"description": "Additional error details",
"additionalProperties": true
}
},
"required": [
"error"
]
},
"BadRequestError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating invalid request parameters or structure"
}
]
},
"UnauthorizedError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating authentication failure"
}
]
},
"ForbiddenError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the authenticated user lacks required permissions"
}
]
},
"NotFoundError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating the requested resource does not exist"
}
]
},
"ServerError": {
"allOf": [
{
"$ref": "#/components/schemas/Error"
},
{
"description": "Error indicating an unexpected server-side issue"
}
]
}
},
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "query",
"name": "api_key",
"description": "RunSignup API Key"
},
"apiSecret": {
"type": "apiKey",
"in": "query",
"name": "api_secret",
"description": "RunSignup API Secret"
}
}
},
"paths": {
"/v2/race-series/race-series-participants/edit.json": {
"post": {
"tags": [
"Race Series Scoring"
],
"summary": "Edit Race Series Participants (BETA)",
"description": "Edit series participants.",
"operationId": "v2_race_series_race_series_participants_edit_json",
"parameters": [
{
"name": "Authorization",
"in": "header",
"description": "OAuth 2.0 Authorization header (e.g. `Bearer ...`).",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "race_series_id",
"in": "query",
"description": "Race series ID.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "race_series_year_id",
"in": "query",
"description": "Race series year ID.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "race_id",
"in": "query",
"description": "Race ID.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "event_id",
"in": "query",
"description": "Event ID.",
"required": true,
"schema": {
"type": "integer"
}
}
],
"security": [
{
"apiKey": [],
"apiSecret": []
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestError"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedError"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ForbiddenError"
}
}
}
},
"404": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundError"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServerError"
}
}
}
}
},
"x-permissions": [
"race_directors",
"timers"
],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"request": {
"type": "string"
}
},
"required": [
"request"
]
}
}
}
}
}
}
}
}
