Skip to content

Update frame system and robot API docs for Python RobotClient.get_pose - #5395

Merged
Eliza Farley (elizafarley) merged 4 commits into
mainfrom
claude/update-robot-get-pose-python
Oct 12, 2026
Merged

Eliza Farley (elizafarley) merged 4 commits into
mainfrom
claude/update-robot-get-pose-python

Conversation

@shannonbradshaw

@shannonbradshaw Shannon Bradshaw (shannonbradshaw) commented Oct 7, 2026 •

Copy link
Copy Markdown
Collaborator

Source changes

  • RSDK-14587 — viam-python-sdk#1270: adds RobotClient.get_pose(component_name, destination_frame="", supplemental_transforms=None), the robot service GetPose. Released in Python SDK v0.83.0 (git tag --contains 514477fb), and now on python.viam.dev.
  • RSDK-13760 — viam-cpp-sdk (ded6cb8): the C++ RobotClient::get_pose, documented on cpp.viam.dev. The docs-agent backlog held this item until Python had the method too.

Documents: no DOCS ticket found for RSDK-14587 or RSDK-13760.

Docs changes

  • .github/workflows/sdk_protos_map.csv: fill the Python column of the robot,GetPose row (get_pose).
  • static/include/robot/apis/generated/robot.md: regenerated with update_sdk_methods.py "" robot. Adds the Python tab for GetPose; no other method changed.
  • static/include/services/apis/overrides/protos/motion.GetPose.md and the regenerated static/include/services/apis/generated/motion.md: the motion service GetPose now says it's deprecated in favor of the machine client's GetPose (Python v0.83.0+, Go, TypeScript), and that Flutter, which has no machine-client version, still uses the motion service method.
  • docs/motion-planning/reference/frame-system-api.md: the GetPose section said "The Python RobotClient does not expose GetPose" and sent Python users to the deprecated motion service get_pose. The Python tab now calls machine.get_pose (v0.83.0 and later), the "Python goes through the motion service" subsection now describes both paths and when to use the motion service one, the kwarg note names RobotClient.get_pose, and the worked example calls machine.get_pose.
  • docs/motion-planning/reference/api.md: the GetPose (deprecated) entry no longer says Python callers use the motion service; it names the machine-client method per SDK and the Flutter exception.
  • docs/build-apps/use-viam-from-an-agent.md: the get_pose example uses machine.get_pose, and the ResourceName compatibility note is scoped to the motion service's get_pose (the new RobotClient.get_pose has always taken a string).

How I found these

  • Xref lookup: service-api-xref.md (RobotService GetPose) and the docs-agent backlog item viam-cpp-sdk-ded6cb8-robot-get-pose.
  • Grep matches: additional pages (frame-system-api.md, api.md, use-viam-from-an-agent.md) from get_pose, GetPose() and "does not expose".

Checks: prettier, markdownlint, vale, make build-prod all pass.


Generated by daily docs change agent

🤖 Generated with Claude Code

https://claude.ai/code/session_01J5WsNbGP1yKuqz7GyobaFN

viam-python-sdk#1270 (RSDK-14587) added RobotClient.get_pose, released in
v0.83.0 and now on python.viam.dev. Fill the Python column of the robot
GetPose row, regenerate the robot API reference, and correct the frame
system API page, which said the Python RobotClient does not expose GetPose.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J5WsNbGP1yKuqz7GyobaFN
@netlify

netlify Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 307ff10
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6ac8ebf75490440008894dab
😎 Deploy Preview https://deploy-preview-5395--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 36 (🔴 down 6 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Oct 7, 2026
The motion API reference still said Python callers use the motion
service GetPose, and the agent guide's get_pose example called the
deprecated motion service method.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Link both GetPose methods from the motion API note, name the
machine-client method per SDK, and note that Flutter has no
machine-client version. Add the same deprecation pointer to the
generated motion API reference through its proto override.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@elizafarley
Eliza Farley (elizafarley) merged commit 83c52b0 into main Oct 12, 2026
14 checks passed
@elizafarley
Eliza Farley (elizafarley) deleted the claude/update-robot-get-pose-python branch October 12, 2026 15:47
@github-actions

Copy link
Copy Markdown

🔎💬 Inkeep AI search and chat service is syncing content for source 'Viam Docs'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants