Goals

This page and its content is in beta - do not use it without consulting our support.

Bob's Goals API provide powerful tools for accessing and managing goals and key results in Bob. These endpoints enable searching, creating, updating, and retrieving goals.

Before you begin

  • Read Explore Goals API to learn how the goals data is organized in Bob and how to use the API, and other Bob APIs to fetch all the information you will need.
  • Read about the object-based API model, which introduces our new approach to the APIs, with AI-ready, consistent data structures, predictable references, and self-describing metadata. The Goals API is fully object-based to help you dynamically build requests, making integrations more robust and future-proof

Goals endpoints

Required permissions

Before accessing goals data, ensure the service user has permission to access the relevant information, just as you would when assigning permissions to a user in Bob.

To learn more, see Goals permissions.

Rate limiting

Rate limits are restrictions that our API imposes on the number of times a user can access our endpoints within a specified period of time. To learn more about rate limiting best practices, see Rate limiting.

Below is a table detailing the rate limits for each endpoint in the Time off endpoints.

MethodLimit request/minute per company
Metadata endpoints200
Search endpoints100
Goals create50
Goal update/status update100
Key results create50
Key results update100
Key results progress update75
Delete endpoints50