Skip to main content
GET
Get a version

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer <key>. Each operation lists the scope its key needs: decisions:evaluate (evaluate and read evaluations), decisions:feedback (your app's feedback) or decisions:develop (everything else, including owner feedback and the review queue). An operation listing no scope takes any scoped key. A key with no scope, or without the operation's, gets 403 INSUFFICIENT_SCOPE.

Path Parameters

decision_id
string
required

A name you choose for this decision, such as refund-exception: a lowercase letter, then up to 127 of a-z 0-9 _ . -. Unique in your organization and shared by its test and production keys. The first registration or evaluation under a new one creates the decision.

Pattern: ^[a-z][a-z0-9_.-]{0,127}$
ref
string
required

The version's structure hash (sha256:…), or its number under the decision (3).

Pattern: ^(?:sha256:[0-9a-f]{64}|[1-9][0-9]{0,8})$
Example:

"1"

Response

The version

structure_hash
string
required
Pattern: ^sha256:[0-9a-f]{64}$
number
integer
required

The version's number under its decision: 1 for the first structure registered, then 2, 3... in the order the organization registered them. For people; the hash is the version's identity.

Required range: x >= 1
question_hashes
object
required

Each question, by name, mapped to its hash (its definition without its name). A question's hash is what feedback about it is stored against.

created_at
string<date-time>
required

When the version was first registered.

structure
object
required

The registered structure, in authored key order.