GRgraypass
canonical

Create a shadow evaluation

Register the action selection, observation window and thresholds for an operational shadow study.

post/api/v1/evaluations

Request

  • Base URL
    https://app.graypass.org (the document declares no server; this is the origin it was published from)
  • URL
    https://app.graypass.org/api/v1/evaluations
  • Auth
    HTTP bearer

Request body

action_keysstring[] required

Registered action keys included in the evaluation; the service deduplicates this selection.

ends_atstring nullable

Timezone-aware ISO 8601 study end, later than starts_at. Creation defaults to 30 days after the start; closing can shorten this cutoff.

namestring required

Customer-visible display name for the action or evaluation.

starts_atstring nullable

Timezone-aware ISO 8601 study start. If omitted during creation, the service uses the current time.

Response

Open evaluation with deduplicated action keys, recorded thresholds and effective observation window.

action_keysstring[] required

Registered action keys included in the evaluation; the service deduplicates this selection.

created_atstring required

Creation time as an ISO 8601 timestamp.

ends_atstring nullable

Timezone-aware ISO 8601 study end, later than starts_at. Creation defaults to 30 days after the start; closing can shorten this cutoff.

idstring required

Identifier of this record. Treat it as opaque and retain it for subsequent operations.

namestring required

Customer-visible display name for the action or evaluation.

starts_atstring required

Timezone-aware ISO 8601 study start. If omitted during creation, the service uses the current time.

status'open' | 'closed' required

Lifecycle state of this record; use the operation-specific values listed in the schema.

Changes

No recorded changes to this operation across all 1 revision of this API.