Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

Retry identity for this immutable target-space request.

Body

application/json
filter
object
required

Recursive metadata predicate defining the eligible target population. Field/operator compatibility and limits come from the immutable filter schema for the selected release. Missing fields use strong Kleene logic; only true records are eligible.

database
string

Database id or slug from homology.databases.list. Omit both database selectors to use the server-advertised default database and release. Mutually exclusive with database_release_id.

Required string length: 1 - 256
database_release_id
string

Exact immutable dbr_ release id returned by the catalog. Omit both database selectors to use the server-advertised default database and release. Mutually exclusive with database.

Pattern: ^dbr_[0-9a-f]{64}$

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/EnvelopeHomologyTargetSpace.json"

data
object

Operation result data.

error
object

Structured error information.

evidence
object

Mechanical evidence summary for agent inspection and chaining.