Skip to main content
POST
Create a retained homology search

Authorizations

Authorization
string
header
required

A Rafflesia API key, sent as Authorization: Bearer <key>.

Headers

Idempotency-Key
string
required

Retry identity for this semantic request. Reuse it after ambiguous failures.

Prefer
string

Transport wait policy: respond-async, wait=N (0–60 seconds), or wait=N with respond-async fallback.

Body

application/json
query
object
required
results
object
required
target
object
required

Exact target population, expressed either inline or by immutable reusable identity.

constraints
object
policy
object

Response

Created

ok
boolean
required

Whether the operation succeeded.

provenance
object
required

Execution provenance.

warnings
object[] | null
required

Non-fatal warnings.

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/EnvelopeHomologySearch.json"

data
object

Operation result data.

error
object

Structured error information.

evidence
object

Mechanical evidence summary for agent inspection and chaining.