Skip to content

Episodes_ReviewSuggestions

POST
/v1/accounts/{account}/datasets/{dataset}/episodes:reviewSuggestions
curl --request POST \
--url https://junction-api.qualiastudios.dev/v1/accounts/example/datasets/example/episodes:reviewSuggestions \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <X-API-Key>' \
--data '{ "parent": "example", "selection": { "names": { "names": [ "example" ] }, "filter": "example" }, "origin": "ORIGIN_UNSPECIFIED", "review": "REVIEW_UNSPECIFIED", "requestId": "example" }'

Settles every PROPOSED subtask span of one origin over the episodes a filter leaves: accept or reject in one call.

account
required
string

The account id.

dataset
required
string

The dataset id.

Media type application/json

Request for Episodes.ReviewSuggestions.

object
parent
required

Accounts/{account}/datasets/{dataset}

string
selection
required

Which episodes.

object
names

Episode names under the request’s parent.

object
names

Accounts/{account}/datasets/{dataset}/episodes/{episode}, at most 10000.

Array<string>
filter

A ListEpisodes filter over the parent (e.g. what the filter bar leaves).

string
origin

Only spans of this origin (MODEL or HEURISTIC); unset means both.

string format: enum
Allowed values: ORIGIN_UNSPECIFIED HUMAN MODEL HEURISTIC
review
required

ACCEPTED or REJECTED.

string format: enum
Allowed values: REVIEW_UNSPECIFIED PROPOSED ACCEPTED REJECTED
requestId

Optional UUID4 identifying this logical edit. Reusing it with the same caller and request returns the original result; different input conflicts. When absent, each call starts a new logical edit.

string

OK

Media type application/json

Response for Episodes.ReviewSuggestions.

object
episodeCount

Episodes that had a span settled.

integer format: int32
spanCount

Spans settled.

integer format: int32
Example generated
{
"episodeCount": 1,
"spanCount": 1
}

Default error response

Media type application/json
One of:
API error

A refusal from the API itself.

object
code
required

The gRPC code name in upper case, e.g. NOT_FOUND.

string
message
required
string
retryable
required

Whether the same call may succeed if retried.

boolean
details
required

Empty, except when a dataset copy or move is refused: then one google.rpc.ErrorInfo with the refusal’s reason code, its domain and, in metadata, the datasets it names.

Array<object>
object
Example generated
{
"code": "example",
"message": "example",
"retryable": true,
"details": [
{}
]
}