---
title: "POST /v1/pose/set"
method: POST
path: "/v1/pose/set"
tags: ["Localization & Navigation"]
---

# POST /v1/pose/set

`POST /v1/pose/set`

## Request

- Base URL: `https://api.bearrobotics.ai`
- URL: `https://api.bearrobotics.ai/v1/pose/set`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bearrobotics/apis/bear-cloud-api/docs/v1/pose/set/post.ts> (a function with typed inputs; its response is checked against the schema)

Update the robot's expected pose on the map.

 Unlike LocalizeRobot, the robot will not attempt to verify whether the pose
 that is set align's with its camera view.

## Request body

- SetPoseRequest: Request object for setting robot pose
  - `robotId` string, required: Unique identifier of the robot
  - `pose` Pose, required: Represents the robot's pose on the map.
    - `xMeters` number, float: X-coordinate in meters within the map.
    - `yMeters` number, float: Y-coordinate in meters within the map.
    - `headingRadians` number, float: The heading of the robot in radians. Ranges from -π to π, where 0.0 points along the positive x-axis.

## Response `200`

OK

- SetPoseResponse

## Other responses

- `400`: Bad Request, usually caused by malfored request body.
- `401`: Unauthorized credentials, ensure the JWT is correct and up to date.
- `500`: Internal Server Error
- `503`: Service is temporarily unavailable, which can usually be resolved by backoff retries.
- `504`: Server-side timeout, usually caused by the failure to send/receive commands/responses to the designated robot.

---

[API](https://skmtc.dev/bearrobotics/apis/bear-cloud-api.md) - [All operations](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/revisions/b90843b624b5?raw)