---
search:
  tags:
    - URDF
    - GET
seo:
  description: >-
    Get the distinct message paths of a single topic, by name, with… Reference
    for the GET /v1/urdf/bindable_topic_message_paths endpoint in the Roboto
    REST API.
sidebar:
  label: Get bindable topic message paths
  badge: GET
title: Get bindable topic message paths
type: openapi-operation
---
Get the distinct message paths of a single topic, by name, with their types and units.

Resolves the topic the same way as ``GET /v1/topics/unique/topic_fields``, but returns one
entry per distinct message path rather than the path alone, carrying the type and unit the
topic's schema versions agree on. Lets the joint-binding dialog tell a scalar path from an
array one without reading a message, and gives field autocomplete something to show beside
each path.

An attribute is populated only when every contributing schema version agrees on it; on
disagreement it is null and named in the entry's ``conflicting_attributes``, so a caller
can never mistake disagreement for an unset value.

``topic_name`` is a query parameter rather than a path segment because topic names contain
slashes (``/imu/data``).

Reads only the normalized schema tables. A topic with no normalized rows yet (e.g. one
predating the topic-schema tables) returns an empty list.

**Consistency:** Eventually consistent by default; override with the
``X-Roboto-Connection-Consistency`` header.

### Access control
 - requires_resource_owner
 - Restricted tokens need the API scope `api.everything_else`

`GET /v1/urdf/bindable_topic_message_paths`