> 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/health-and-fitness-api/routes.md).

# Routes

GPS routes, and pushing them to users' devices for on-device navigation.

## List routes

> Returns every route created with your credentials, as a JSON array.\
> \
> \- Apart from waypoint coordinates, fields whose value is zero or empty are left out of each route.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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":{"Route":{"type":"object","description":"A stored route. Apart from waypoint coordinates, fields whose value is zero or empty are left out.","properties":{"route_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"sport":{"$ref":"#/components/schemas/RouteSport"},"elevation_gain_meters":{"type":"number"},"elevation_loss_meters":{"type":"number"},"speed_meters_per_second":{"type":"number"},"waypoints":{"type":"array","items":{"$ref":"#/components/schemas/RouteWaypoint"}}}},"RouteSport":{"type":"string","enum":["running","trail_running","hiking","cycling","road_biking","mountain_biking","gravel_cycling","other"]},"RouteWaypoint":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation_meters":{"type":"number","minimum":-500,"maximum":9000},"course_point":{"$ref":"#/components/schemas/RouteCoursePoint"}}},"RouteCoursePoint":{"type":"object","description":"A point of interest marked at a waypoint, shown on devices that support course points.","required":["type"],"properties":{"type":{"type":"string","enum":["generic","summit","valley","water","food","danger","left","right","straight","first_aid","sprint","segment_start","segment_end","left_fork","right_fork"]},"name":{"type":"string"}}},"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"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/routes":{"get":{"tags":["Routes"],"summary":"List routes","description":"Returns every route created with your credentials, as a JSON array.\n\n- Apart from waypoint coordinates, fields whose value is zero or empty are left out of each route.","operationId":"Routes_ListRoutes","responses":{"200":{"description":"Your routes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Route"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Create a route

> Stores a reusable GPS route and returns its \`route\_id\`.\
> \
> \- The route is not sent to any device until you push it to a user with \`POST /routes/{route\_id}/push\`.\
> \- When every waypoint has \`elevation\_meters\`, elevation gain and loss are computed from them unless you set them.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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":{"RouteCreateRequest":{"type":"object","required":["name","sport","waypoints"],"properties":{"name":{"type":"string","minLength":1,"maxLength":255,"description":"The name shown on the device."},"description":{"type":"string","maxLength":2000,"description":"Used only by providers that show a route description."},"sport":{"$ref":"#/components/schemas/RouteSport"},"elevation_gain_meters":{"type":"number","minimum":0},"elevation_loss_meters":{"type":"number","minimum":0},"speed_meters_per_second":{"type":"number","exclusiveMinimum":0,"description":"Target average speed, used only by providers that support one."},"waypoints":{"type":"array","minItems":2,"maxItems":10000,"items":{"$ref":"#/components/schemas/RouteWaypoint"}}}},"RouteSport":{"type":"string","enum":["running","trail_running","hiking","cycling","road_biking","mountain_biking","gravel_cycling","other"]},"RouteWaypoint":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation_meters":{"type":"number","minimum":-500,"maximum":9000},"course_point":{"$ref":"#/components/schemas/RouteCoursePoint"}}},"RouteCoursePoint":{"type":"object","description":"A point of interest marked at a waypoint, shown on devices that support course points.","required":["type"],"properties":{"type":{"type":"string","enum":["generic","summit","valley","water","food","danger","left","right","straight","first_aid","sprint","segment_start","segment_end","left_fork","right_fork"]},"name":{"type":"string"}}},"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"]},"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"]}},"responses":{"BadRequest":{"description":"One or more parameters is malformed. The `detail` field describes the specific problem.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/routes":{"post":{"tags":["Routes"],"summary":"Create a route","description":"Stores a reusable GPS route and returns its `route_id`.\n\n- The route is not sent to any device until you push it to a user with `POST /routes/{route_id}/push`.\n- When every waypoint has `elevation_meters`, elevation gain and loss are computed from them unless you set them.","operationId":"Routes_CreateRoute","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteCreateRequest"}}}},"responses":{"200":{"description":"Route created","content":{"application/json":{"schema":{"type":"object","required":["status","route_id"],"properties":{"status":{"type":"string","enum":["success"]},"route_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Update a route

> Changes the fields you send, keeps the rest, and re-sends the route to every user it was pushed to, each under its existing provider ID.\
> \
> \- Sending \`waypoints\` replaces them all, and recomputes elevation gain and loss when every new waypoint has \`elevation\_meters\`.\
> \- An empty \`description\` clears it.\
> \- Each re-send to a device is billed like a push.\
> \- The response lists each pushed copy's outcome: \`skipped\` ones cannot be re-sent (for example, the user disconnected); repeat the request to re-send \`failed\` ones.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"RouteId":{"name":"route_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The route's ID, as returned by `POST /routes`."}},"schemas":{"RouteUpdateRequest":{"type":"object","description":"Every field is optional; fields you leave out keep their value.","properties":{"name":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":2000,"description":"An empty string clears the description."},"sport":{"$ref":"#/components/schemas/RouteSport"},"elevation_gain_meters":{"type":"number","minimum":0},"elevation_loss_meters":{"type":"number","minimum":0},"speed_meters_per_second":{"type":"number","exclusiveMinimum":0},"waypoints":{"type":"array","minItems":2,"maxItems":10000,"items":{"$ref":"#/components/schemas/RouteWaypoint"}}}},"RouteSport":{"type":"string","enum":["running","trail_running","hiking","cycling","road_biking","mountain_biking","gravel_cycling","other"]},"RouteWaypoint":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"elevation_meters":{"type":"number","minimum":-500,"maximum":9000},"course_point":{"$ref":"#/components/schemas/RouteCoursePoint"}}},"RouteCoursePoint":{"type":"object","description":"A point of interest marked at a waypoint, shown on devices that support course points.","required":["type"],"properties":{"type":{"type":"string","enum":["generic","summit","valley","water","food","danger","left","right","straight","first_aid","sprint","segment_start","segment_end","left_fork","right_fork"]},"name":{"type":"string"}}},"RouteCopiesResponse":{"type":"object","required":["route_id","pushed_routes"],"properties":{"status":{"type":"string","enum":["success"],"description":"Present when every reachable copy succeeded (200)."},"message":{"type":"string","description":"Present when some copies failed (207). Repeat the request to retry them."},"route_id":{"type":"string"},"pushed_routes":{"type":"array","items":{"$ref":"#/components/schemas/RouteCopyResult"}}}},"RouteCopyResult":{"type":"object","required":["pushed_route_id","status"],"properties":{"pushed_route_id":{"type":"string"},"provider_route_id":{"type":"string","description":"The copy's ID at the provider after the request."},"status":{"type":"string","enum":["updated","deleted","failed","skipped"]},"error":{"type":"string","description":"Why the copy was not updated or removed."}}},"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"]},"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"]}},"responses":{"BadRequest":{"description":"One or more parameters is malformed. The `detail` field describes the specific problem.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"RouteBusy":{"description":"Another request is changing this route; retry shortly.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/routes/{route_id}":{"put":{"tags":["Routes"],"summary":"Update a route","description":"Changes the fields you send, keeps the rest, and re-sends the route to every user it was pushed to, each under its existing provider ID.\n\n- Sending `waypoints` replaces them all, and recomputes elevation gain and loss when every new waypoint has `elevation_meters`.\n- An empty `description` clears it.\n- Each re-send to a device is billed like a push.\n- The response lists each pushed copy's outcome: `skipped` ones cannot be re-sent (for example, the user disconnected); repeat the request to re-send `failed` ones.","operationId":"Routes_UpdateRoute","parameters":[{"$ref":"#/components/parameters/RouteId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteUpdateRequest"}}}},"responses":{"200":{"description":"Route saved and re-sent to every pushed copy that could be reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteCopiesResponse"}}}},"207":{"description":"Route saved, but some re-sends failed. Repeat the request to re-send them.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteCopiesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/RouteBusy"},"422":{"description":"The route has been pushed to more users than one update can re-send to (50).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Delete a route

> Removes every pushed copy of the route from users' devices, then deletes the route.\
> \
> \- If any copy could not be removed, the route is kept and the response lists each copy's outcome; repeat the request to finish deleting it.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"RouteId":{"name":"route_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The route's ID, as returned by `POST /routes`."}},"schemas":{"RouteCopiesResponse":{"type":"object","required":["route_id","pushed_routes"],"properties":{"status":{"type":"string","enum":["success"],"description":"Present when every reachable copy succeeded (200)."},"message":{"type":"string","description":"Present when some copies failed (207). Repeat the request to retry them."},"route_id":{"type":"string"},"pushed_routes":{"type":"array","items":{"$ref":"#/components/schemas/RouteCopyResult"}}}},"RouteCopyResult":{"type":"object","required":["pushed_route_id","status"],"properties":{"pushed_route_id":{"type":"string"},"provider_route_id":{"type":"string","description":"The copy's ID at the provider after the request."},"status":{"type":"string","enum":["updated","deleted","failed","skipped"]},"error":{"type":"string","description":"Why the copy was not updated or removed."}}},"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"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"RouteBusy":{"description":"Another request is changing this route; retry shortly.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/routes/{route_id}":{"delete":{"tags":["Routes"],"summary":"Delete a route","description":"Removes every pushed copy of the route from users' devices, then deletes the route.\n\n- If any copy could not be removed, the route is kept and the response lists each copy's outcome; repeat the request to finish deleting it.","operationId":"Routes_DeleteRoute","parameters":[{"$ref":"#/components/parameters/RouteId"}],"responses":{"204":{"description":"Route and every pushed copy deleted"},"207":{"description":"Some pushed copies could not be removed, so the route was kept. Repeat the request to finish deleting it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteCopiesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/RouteBusy"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Push a route to a user's device

> Sends the route to the user's connected provider, where it appears on their device after its next sync.\
> \
> \- Pushing a route the user already has re-sends that copy and returns \`200\`; a first push creates a pushed route and returns \`201\`.\
> \- Each push is billed like pushing a planned workout.\
> \- Returns \`404\` when the user's provider does not support routes.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"RouteId":{"name":"route_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The route's ID, as returned by `POST /routes`."}},"schemas":{"RoutePushResponse":{"type":"object","required":["status","pushed_route_id"],"properties":{"status":{"type":"string","enum":["success"]},"pushed_route_id":{"type":"string"},"provider_route_id":{"type":"string","description":"The route's ID at the provider."}}},"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"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"RouteBusy":{"description":"Another request is changing this route; retry shortly.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/routes/{route_id}/push":{"post":{"tags":["Routes"],"summary":"Push a route to a user's device","description":"Sends the route to the user's connected provider, where it appears on their device after its next sync.\n\n- Pushing a route the user already has re-sends that copy and returns `200`; a first push creates a pushed route and returns `201`.\n- Each push is billed like pushing a planned workout.\n- Returns `404` when the user's provider does not support routes.","operationId":"Routes_PushRoute","parameters":[{"$ref":"#/components/parameters/RouteId"},{"name":"user_id","in":"query","required":true,"schema":{"type":"string"},"description":"The Terra user ID of the connection to push the route to."}],"responses":{"200":{"description":"The user's existing copy was re-sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoutePushResponse"}}}},"201":{"description":"The route was pushed to the user for the first time","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoutePushResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/RouteBusy"},"424":{"description":"The provider rejected the route; retry later.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## List a user's pushed routes

> Returns every route pushed to the user, as a JSON array.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"PushedRouteUserId":{"name":"user_id","in":"query","required":true,"schema":{"type":"string"},"description":"The Terra user ID of the connection the route was pushed to."}},"schemas":{"PushedRoute":{"type":"object","required":["pushed_route_id","is_external","created_at","last_updated_at"],"properties":{"pushed_route_id":{"type":"string"},"route_id":{"type":"string","description":"The route this copy was pushed from. Absent when the copy was not pushed through Terra."},"provider_route_id":{"type":"string","description":"The copy's ID at the provider."},"is_external":{"type":"boolean","description":"True when the copy was not pushed through Terra."},"created_at":{"type":"string","format":"date-time"},"last_updated_at":{"type":"string","format":"date-time"}}},"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"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/pushedRoutes":{"get":{"tags":["Routes"],"summary":"List a user's pushed routes","description":"Returns every route pushed to the user, as a JSON array.","operationId":"Routes_ListPushedRoutes","parameters":[{"$ref":"#/components/parameters/PushedRouteUserId"}],"responses":{"200":{"description":"The user's pushed routes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PushedRoute"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Get a pushed route

> Returns one route pushed to the user.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"PushedRouteId":{"name":"pushed_route_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The pushed route's ID, as returned by `POST /routes/{route_id}/push`."},"PushedRouteUserId":{"name":"user_id","in":"query","required":true,"schema":{"type":"string"},"description":"The Terra user ID of the connection the route was pushed to."}},"schemas":{"PushedRoute":{"type":"object","required":["pushed_route_id","is_external","created_at","last_updated_at"],"properties":{"pushed_route_id":{"type":"string"},"route_id":{"type":"string","description":"The route this copy was pushed from. Absent when the copy was not pushed through Terra."},"provider_route_id":{"type":"string","description":"The copy's ID at the provider."},"is_external":{"type":"boolean","description":"True when the copy was not pushed through Terra."},"created_at":{"type":"string","format":"date-time"},"last_updated_at":{"type":"string","format":"date-time"}}},"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"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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":{"/pushedRoutes/{pushed_route_id}":{"get":{"tags":["Routes"],"summary":"Get a pushed route","operationId":"Routes_GetPushedRoute","description":"Returns one route pushed to the user.","parameters":[{"$ref":"#/components/parameters/PushedRouteId"},{"$ref":"#/components/parameters/PushedRouteUserId"}],"responses":{"200":{"description":"The pushed route","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushedRoute"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```

## Delete a pushed route

> Removes the route from the user's device, then deletes the pushed route.\
> \
> \- The pushed route is deleted even if the provider could not remove it from the device; the route itself is kept.

```json
{"openapi":"3.2.0","info":{"title":"Terra API","version":"2026.11.19"},"tags":[{"name":"Routes","summary":"Routes","description":"GPS routes, and pushing them to users' devices for on-device navigation."}],"servers":[{"url":"https://access.tryterra.co/api/v2"}],"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"}},"parameters":{"PushedRouteId":{"name":"pushed_route_id","in":"path","required":true,"schema":{"type":"integer","format":"int64"},"description":"The pushed route's ID, as returned by `POST /routes/{route_id}/push`."},"PushedRouteUserId":{"name":"user_id","in":"query","required":true,"schema":{"type":"string"},"description":"The Terra user ID of the connection the route was pushed to."}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"Forbidden":{"description":"The credential is not authorized (code scope_missing or audience_restricted), the environment is disabled (environment_disabled), or the required product entitlement is missing (entitlement_required).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"A referenced resource does not exist on Terra's end.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"RouteBusy":{"description":"Another request is changing this route; retry shortly.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"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"}}}}},"schemas":{"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"]}}},"paths":{"/pushedRoutes/{pushed_route_id}":{"delete":{"tags":["Routes"],"summary":"Delete a pushed route","operationId":"Routes_DeletePushedRoute","description":"Removes the route from the user's device, then deletes the pushed route.\n\n- The pushed route is deleted even if the provider could not remove it from the device; the route itself is kept.","parameters":[{"$ref":"#/components/parameters/PushedRouteId"},{"$ref":"#/components/parameters/PushedRouteUserId"}],"responses":{"204":{"description":"Pushed route deleted"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/RouteBusy"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}}}}}}
```
