1. RunSignup
  2. API
  3. Methods
  4. Manage Race Group/Team Types

Manage Race Group/Team Types

Manage race group/team types. This API does not support all settings available through the UI. If a race has already set up group/team types through the UI, be careful with modifying them via this API. To edit a group/team type, include the team_type_id field with the group type information. Any existing group/team type not included in the request will be deleted. Returns group/team type IDs in the order specified.

For JSON requests, the request should look like the example below.

{
	"race_team_types": [
		{
      "team_type_id": 1123,
			"team_type": "Competitive Team",
			"team_type_desc": "Competitive Team Description",
			"min_members": 0,
			"max_members": null,
			"min_male_members": 1,
			"max_male_members": null,
			"min_female_members": 1,
			"max_female_members": null,
			"max_num_teams": null,
			"valid_event_ids": [11428, 11429],
			"require_gender_selection": "T",
			"allow_all_male_team": "T",
			"allow_all_female_team": "T",
			"allow_coed_team": "F",
			"allow_nonbinary_in_male_or_female": "F"
		}
	]
}

For XML requests, the request should look like the example below.

<race_team_types>
	<race_team_type>
		<team_type_id>1123</team_type_id>
		<team_type>Competitive Team</team_type>
		<team_type_desc>Competitive Team Description</team_type_desc>
		<min_members>0</min_members>
		<max_members></max_members>
		<min_male_members>1</min_male_members>
		<max_male_members></max_male_members>
		<min_female_members>1</min_female_members>
		<max_female_members></max_female_members>
		<max_num_teams></max_num_teams>
		<valid_event_ids>
			<event_id>11428</event_id>
			<event_id>11429</event_id>
		</valid_event_ids>
		<require_gender_selection>T</require_gender_selection>
		<allow_all_male_team>T</allow_all_male_team>
		<allow_all_female_team>T</allow_all_female_team>
		<allow_coed_team>F</allow_coed_team>
		<allow_nonbinary_in_male_or_female>F</allow_nonbinary_in_male_or_female>
	</race_team_type>
</race_team_types>

URL

https://www.givesignup.org/rest/race/:race_id/teams/team-types

HTTP Method

POST

Standard Parameters

Parameter HTTP Method Default Description Datatype
api_key GET API Key string
api_secret GET API Secret string
tmp_key GET Temporary API Key from login API call. This should NOT be used in combination with API Key. string
tmp_secret GET Temporary API Secret from login API call. This should NOT be used in combination with API Secret. string
rsu_api_key GET API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. string
sp_api_key GET Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. string
X-RSU-API-SECRET HTTP Header API v2 or super partner secret. string
format GET xml Format of response. The default if not sent is `xml`, but `json` is preferred. format

Parameters

Parameter HTTP Method Default Description Datatype
race_id
Required
POST ID of race. uint
race_event_days_id
Required
POST Race event days ID. This ID groups together events, typically by year. This ID is returned with the event information in the APIs to get races or a single race. uint
request_format POST xml Format of request. The default if not sent is `xml`, but `json` is preferred. format
request
Required
POST Request in proper format. string

If you continue to use this site, you consent to use all cookies. We use cookies to offer you a better browsing experience. Read how we use cookies and how you can control them by visiting our Privacy Policy.

If you continue to use this site, you consent to use all cookies.