Skip to content

Regenerate API docs: fix CSV, add missing methods, remove deprecated#4909

Merged
shannonbradshaw merged 7 commits intoviamrobotics:new-docs-sitefrom
shannonbradshaw:content/dev
Apr 13, 2026
Merged

Regenerate API docs: fix CSV, add missing methods, remove deprecated#4909
shannonbradshaw merged 7 commits intoviamrobotics:new-docs-sitefrom
shannonbradshaw:content/dev

Conversation

@shannonbradshaw
Copy link
Copy Markdown
Collaborator

Summary

Fixes the SDK method mapping CSV and regenerates all API reference content from current published SDK documentation.

CSV fixes

Removed deprecated methods:

  • camera.GetImage (removed from all SDKs, only GetImages exists)
  • camera.RenderFrame (removed from all SDKs)
  • data_manager.UploadImageToDatasets (renamed to UploadBinaryDataToDatasets)

Added missing methods (Python SDK):

  • motor.GetGeometries
  • servo.GetGeometries
  • data.AddTagsToBinaryDataByFilter
  • data.CreateBinaryDataSignedURL
  • data.CreateIndex
  • data.DeleteIndex
  • data.ListIndexes
  • data.RemoveTagsFromBinaryDataByFilter
  • data.UpdateBoundingBox
  • billing.ChargeOrganization

Regenerated content

Ran update_sdk_methods.py coverage check which regenerated all 40 generated API content files from current published SDK docs (python.viam.dev, pkg.go.dev, flutter.viam.dev, ts.viam.dev).

Key changes in generated output:

  • Camera: removed deprecated GetImage and RenderFrame sections
  • Motor: added GetGeometries section
  • Servo: added GetGeometries section
  • Data client: added 7 new method sections
  • Billing: added ChargeOrganization section

Not included

~30 methods exist in Go SDK source but not on published pkg.go.dev (unreleased). These will be added when the next Go SDK version is released and the generator is re-run.

Test plan

  • Build passes
  • Netlify deploy preview succeeds
  • New method sections appear on motor, servo, data client, billing pages
  • Camera page no longer shows GetImage or RenderFrame

🤖 Generated with Claude Code

shannonbradshaw and others added 4 commits April 13, 2026 10:14
CSV fixes (sdk_protos_map.csv):
- Add motor.GetGeometries (Python only)
- Add servo.GetGeometries (Python only)
- Delete stale data_manager.UploadImageToDatasets (renamed to
  UploadBinaryDataToDatasets)
- Fix billing.GetInvoicePDF -> GetInvoicePdf (match proto case)
- Add 10 fleet methods (Go SDK only): DisableBillingService,
  EnableBillingService, GetBillingServiceConfig, ListOAuthApps,
  OrganizationGet/SetLogo, OrganizationGet/SetSupportEmail,
  TransferRegistryItem, UpdateBillingService
- Add 7 data methods: AddTagsToBinaryDataByFilter, CreateBinaryDataSignedURL,
  CreateIndex, DeleteIndex, ListIndexes, RemoveTagsFromBinaryDataByFilter,
  UpdateBoundingBox
- Add 2 billing methods: ChargeOrganization, SendPaymentRequiredEmail
- Add 1 ml_training method: GetTrainingJobLogs (Go only)
- Add 4 robot methods (Go only): GetPose, ListTunnels, SendTraces, Tunnel

Delete SLAM API page:
- Remove reference/apis/services/SLAM.md (not documenting SLAM)
- Add alias redirects on services/_index.md for old SLAM URLs
- Remove SLAM card from reference/apis/_index.md

Note: 31 proto methods remain undocumented because they are not
implemented in any SDK (OAuth, Firebase, push tokens, fragment tags,
saved queries, billing tiers, ListSupportedContainers). These need
SDK implementations before they can be documented.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The first commit added /dev/reference/apis/services/SLAM/ as an alias
on the SLAM page. The second commit deleted the page, losing that alias.
Add it to services/_index.md so the path still resolves.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Remove SLAM aliases from services/_index.md and add them to the
APIs overview (_index.md) instead. All SLAM URLs now redirect to the
APIs overview page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
CSV fixes:
- Remove deprecated camera.GetImage and camera.RenderFrame (removed
  from all SDKs, only GetImages exists)
- Remove GetInvoicePDF case "fix" (Go SDK uses PDF not Pdf)
- Remove Go-only methods not yet on published SDK docs (will be added
  when next Go SDK version is released)
- Add 7 data methods (Python only): AddTagsToBinaryDataByFilter,
  CreateBinaryDataSignedURL, CreateIndex, DeleteIndex, ListIndexes,
  RemoveTagsFromBinaryDataByFilter, UpdateBoundingBox
- Add billing.ChargeOrganization (Python only)
- Keep motor.GetGeometries and servo.GetGeometries (Python only)

Regenerated content (40 files):
- All component, service, and platform API generated .md files updated
  from current published SDK docs
- Camera: removed GetImage and RenderFrame sections
- Motor: added GetGeometries section
- Servo: added GetGeometries section
- Data: added 7 new method sections
- Billing: added ChargeOrganization section

Added 6 proto override description files for new methods.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 13, 2026

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit b1c94b5
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/69dd151857e16b000805b0ff
😎 Deploy Preview https://deploy-preview-4909--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 9 from production)
Accessibility: 99 (🔴 down 1 from production)
Best Practices: 92 (no change from production)
SEO: 89 (🔴 down 3 from production)
PWA: 60 (🔴 down 10 from production)
View the detailed breakdown and full score reports

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

shannonbradshaw and others added 2 commits April 13, 2026 10:53
Update 4 links in dev/reference/changelog.md from #getimage to
#getimages since GetImage was removed from the camera API docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The previous replace_all of #getimage -> #getimages also matched
the existing #getimages, producing #getimagess.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Generator scraped stale method name update_bounding_box_to_image_by_id
from outdated published Python SDK docs. Correct name is
update_bounding_box. Also fixed missing comma and incorrect return
value assignment in the example.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shannonbradshaw shannonbradshaw merged commit 5eb980b into viamrobotics:new-docs-site Apr 13, 2026
11 of 12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant