api

package module
v0.1.500 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 11, 2025 License: Apache-2.0 Imports: 0 Imported by: 0

README

API

Protobuf definitions for Viam's public-facing API.

Contributing

Development

Our development environment has some dependencies that you should install through your system's package manager:

  • curl
  • gpg (called gnupg in Homebrew)

We use mise-en-place to manage additional required tools. You can install it on MacOS and most Linux distributions with the following command:

curl https://mise.run | sh

Note that the install script will print instructions for activating mise in your shell that you will need to follow to get a working build environment.

Mise is also available in Homebrew and several package repositories. See the official documentation for a list of installation methods.

For security, mise requires projects to be trusted before it will load their configuration. Normally it will prompt you for this the first time you run any mise commands within the repo, but if it doesn't and you are seeing errors like mise ERROR no tasks defined in ~/api. Are you in a project directory?, try manually trusting the workspace by running mise trust.

Once mise is set up you can run mise tasks to view the available targets. Some common ones are:

  • mise r -f buf - Unconditionally build the Go and web generated libraries
  • mise r clean - Remove untracked files from the workspace
Submitting PRs for Protobuf Changes

Please only edit .proto files. The generated interfaces build in CI.

To build protos for a PR:

  • add the ready-for-protos label
  • adding the label will compile your protos, and commit the compiled changes to your PR branch from the github-actions bot
    • the bot commit will also add a protos-compiled label which is checked to merge. subsequent manual commits remove this label
  • when you're ready to merge, remove the ready-for-protos label; that will trigger lint and merge checks
  • in order to merge, the last commit to your PR must be a bot commit. (this is enforced through labeling)

Other guidelines:

  • Do not make breaking changes to APIs if it can be avoided.
  • Always use semantic version tags (not hashes) when importing this into other projects, such as RDK.
    • For example, use go get go.viam.com/api@v0.1.180 NOT go get go.viam.com/api@037415e
    • Add a new (semantic version compatible) tag when needed for this.
    • Do NOT duplicate, move, or remove version tags.

License

Copyright 2023 Viam Inc.

Apache 2.0 - See LICENSE file

Documentation

Overview

Package api TODO

Source Files

View all Source files

Directories

Path Synopsis
app
agent/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
build/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
cloudslam/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
data/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
datapipelines/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
dataset/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
datasync/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
mlinference/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
mltraining/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
model/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
packages/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
common
v1
component
arm/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
audioin/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
audioinput/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
audioout/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
base/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
board/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
button/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
camera/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
encoder/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
gantry/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
generic/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
gripper/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
inputcontroller/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
motor/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
movementsensor/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
posetracker/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
powersensor
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
powersensor/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
sensor/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
servo/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
switch/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
testecho/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
module
v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
opentelemetry
proto/common/v1
proto/resource/v1
proto/trace/v1
provisioning
v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
robot
v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
service
datamanager/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
discovery/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
generic/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
mlmodel/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
motion/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
navigation/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
sensors/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
shell/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
slam/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
video
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
video/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
vision/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
worldstatestore/v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
stream
v1
Package v1 is a reverse proxy.
 Package v1 is a reverse proxy.
tagger
v1

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.