> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/reference/teams-api/athletes.md).

# Athletes

List, read and update athletes.

## List all athletes

> Lists the athletes under all of your coaches.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Athletes","summary":"Athletes","description":"List, read and update athletes."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"AthletesReturned":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Athlete"}}}},"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/athletes":{"get":{"operationId":"getAthletes","description":"Lists the athletes under all of your coaches.","summary":"List all athletes","responses":{"200":{"description":"An array of athletes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthletesReturned"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Athletes"]}}}}
```

## Bulk update multiple athletes

> Updates several athletes in one request, and returns the athletes it updated with an error for each update that failed.\
> \
> \- Only \`reference\_id\` and \`active\` can change here; use \`PATCH /athletes/{athleteId}\` for the other fields.\
> \- A field sent as \`null\` or left out is unchanged; an update cannot clear a field.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Athletes","summary":"Athletes","description":"List, read and update athletes."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"AthletePartialUpdate":{"type":"object","properties":{"athlete_id":{"type":"string","description":"Unique identifier of the athlete to update."},"active":{"type":"boolean","description":"Whether the athlete is active."},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."}},"required":["athlete_id"]},"BulkPatchResponse":{"type":"object","properties":{"data":{"type":"array","description":"Array of successfully updated athlete objects.","items":{"$ref":"#/components/schemas/Athlete"}},"errors":{"type":"array","description":"Array of errors for failed updates.","items":{"$ref":"#/components/schemas/ErrorItem"}}},"required":["data","errors"]},"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"ErrorItem":{"type":"object","properties":{"athlete_id":{"type":"string","description":"ID of the athlete for which the error occurred."},"error":{"type":"string","description":"Error message."}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorResponse":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":["string","null"],"format":"uri"}},"required":["type","title","status","detail"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/athletes":{"patch":{"summary":"Bulk update multiple athletes","description":"Updates several athletes in one request, and returns the athletes it updated with an error for each update that failed.\n\n- Only `reference_id` and `active` can change here; use `PATCH /athletes/{athleteId}` for the other fields.\n- A field sent as `null` or left out is unchanged; an update cannot clear a field.","tags":["Athletes"],"operationId":"bulkPatchAthletes","parameters":[{"name":"dev-id","in":"header","description":"Your developer ID","required":true,"schema":{"type":"string"}},{"name":"x-api-key","in":"header","description":"Your API key","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"JSON payload containing an array of athlete updates.","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Array of partial athlete objects for update.","items":{"$ref":"#/components/schemas/AthletePartialUpdate"}}},"required":["data"]}}}},"responses":{"200":{"description":"All athlete updates were successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkPatchResponse"}}}},"207":{"description":"Partial success, some athletes updated while others failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkPatchResponse"}}}},"400":{"description":"Bad Request. Invalid input or all updates failed due to validation errors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkPatchResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Unauthorized. Invalid credentials provided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Retrieve a specific athlete by their ID

> Returns one of your athletes.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Athletes","summary":"Athletes","description":"List, read and update athletes."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/athletes/{athleteId}":{"get":{"operationId":"getAthlete","description":"Returns one of your athletes.","summary":"Retrieve a specific athlete by their ID","parameters":[{"name":"athleteId","in":"path","required":true,"schema":{"type":"string"},"description":"The athlete's `athlete_id`."}],"responses":{"200":{"description":"Detailed information about the athlete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Athlete"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"No athlete with this `athlete_id` is registered under your coaches. The `error` says `Coach not found`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Athletes"]}}}}
```

## Update an athlete's information

> Changes the fields you send on an athlete.\
> \
> \- A field sent as \`null\` or left out is unchanged; an update cannot clear a field.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Athletes","summary":"Athletes","description":"List, read and update athletes."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/athletes/{athleteId}":{"patch":{"operationId":"updateAthlete","description":"Changes the fields you send on an athlete.\n\n- A field sent as `null` or left out is unchanged; an update cannot clear a field.","summary":"Update an athlete's information","parameters":[{"name":"athleteId","in":"path","required":true,"schema":{"type":"string"},"description":"The `athlete_id` of the athlete to update."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Athlete"}}}},"responses":{"200":{"description":"Athlete updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Athlete"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"No athlete with this `athlete_id` is registered under your coaches. The `error` says `Coach not found`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Athletes"]}}}}
```
