Orb's API now supports the dry running of requests. Dry running API requests allows you to validate the correctness of a request without making any actual changes to the system. This feature is particularly useful for ensuring that the request does not contain any errors and for previewing the potential response of a mutation before committing it.

Dry-running a request is as simple as including a “Dry-Run” header with a value of “True”, as shown below:

curl --request POST \
     --url https://api.withorb.com/v1/subscriptions \
      --header 'Dry-Run: True' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer null' \
     --header 'Content-Type: application/json'

More information can be found in our documentation.

The evaluate price API endpoint allows you to leverage multiple SQL expressions in order to dynamically query your data, just as you would use SQL expressions in constructing your metric. The set of filter and grouping expressions need not be configured up-front or known to Orb to pre-aggregate; instead, you’re able to perform these actions on-demand as they become necessary. Because SQL expressions are supported (as opposed to more basic support for event properties), you can use conditional statements and other logical operators.

This endpoint could be used to:

• View usage for your compute metric broken down by cluster_name, where a user may have hundreds of clusters active in a given time period.
• Build an interactive explorer in your application to view hourly data over a day time range, rather than the default daily views available through Orb’s subscription usage and cost APIs.
• Provide a view into end customer usage by api_key prefix, allowing users to understand the source of API requests.

Learn more about this endpoint in the Orb docs. Happy query-ing! 

Starting today, SDKs for Orb are available in Python (orb-billing on PyPI), Node.js/Typescript (orb-billing on NPM), and Go (github.com/orbcorp/orb-go). We’re pretty excited about the ergonomic wins these SDKs bring when it comes to integrating with Orb. They offer a wide range of benefits including autocomplete, static checking, retries, idempotency support, and more!

Additionally, if an Orb SDK isn’t available in your language of choice, our OpenAPI spec can help you get up and running with one quickly!