cURL
curl --request GET \
--url "https://api.rafflesia.ai/v1/homology/databases/{database_id}/releases?limit=20" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY"{
"data": [
{
"aliases": [
"<string>"
],
"corpus_snapshot_id": "<string>",
"database_id": "<string>",
"homology_search_capability": {
"billable_formula_id": "tomato.object_reads_plus_logical_mib.v1",
"evidence": [
"candidate_measurement"
],
"guarantees": [
"approximate"
],
"maximum_results": 1,
"query_kinds": [
"protein_sequence"
],
"significance": {
"requirements": [
"not_requested"
],
"status": "available",
"calibration_scope": "release",
"unavailable_reason": "<string>"
},
"status": "available",
"filter_schema": {
"database_release_id": "<string>",
"fields": [
{
"field_type": "string",
"name": "<string>",
"operators": [
"<string>"
]
}
],
"id": "<string>",
"limits": {
"maximum_bytes": 123,
"maximum_depth": 123,
"maximum_field_bytes": 123,
"maximum_nodes": 123,
"maximum_scalar_bytes": 123,
"maximum_values": 123
},
"metadata_manifest_sha256": "<string>",
"metadata_release_id": "<string>",
"missing_field_semantics": "turbopuffer",
"object": "<string>",
"search_policy_ids": [
"<string>"
],
"$schema": "https://example.com/schemas/HomologyFilterSchema.json"
},
"ranking": {
"comparability": "within_query_only",
"order": "ascending",
"primary_measurement": "maxsim.bidirectional",
"scope": "resolved_policy_frontier",
"tie_breakers": [
{
"field": "maxsim.bidirectional",
"order": "ascending"
}
]
},
"unavailable_reason": "<string>"
},
"id": "<string>",
"object": "homology_database_release",
"record_count": 1,
"residue_count": 1,
"status": "available",
"compiler_version": "<string>",
"corpus_published_at": "2023-11-07T05:31:56Z",
"manifest_sha256": "<string>"
}
],
"list_metadata": {
"after": "<string>",
"before": "<string>"
},
"object": "list",
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/HomologyDatabaseReleaseList.json"
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}List the immutable releases of a homology database
Returns one cursor page of a database’s immutable releases, ordered by release id, each with its record and residue counts, its aliases, and the release-owned capability contract naming the search policies and evidence it can serve. A release id always identifies the same searched content. A release whose capability cannot currently be resolved is reported as unavailable with a warning rather than dropped from the page.
GET
/
v1
/
homology
/
databases
/
{database_id}
/
releases
cURL
curl --request GET \
--url "https://api.rafflesia.ai/v1/homology/databases/{database_id}/releases?limit=20" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY"{
"data": [
{
"aliases": [
"<string>"
],
"corpus_snapshot_id": "<string>",
"database_id": "<string>",
"homology_search_capability": {
"billable_formula_id": "tomato.object_reads_plus_logical_mib.v1",
"evidence": [
"candidate_measurement"
],
"guarantees": [
"approximate"
],
"maximum_results": 1,
"query_kinds": [
"protein_sequence"
],
"significance": {
"requirements": [
"not_requested"
],
"status": "available",
"calibration_scope": "release",
"unavailable_reason": "<string>"
},
"status": "available",
"filter_schema": {
"database_release_id": "<string>",
"fields": [
{
"field_type": "string",
"name": "<string>",
"operators": [
"<string>"
]
}
],
"id": "<string>",
"limits": {
"maximum_bytes": 123,
"maximum_depth": 123,
"maximum_field_bytes": 123,
"maximum_nodes": 123,
"maximum_scalar_bytes": 123,
"maximum_values": 123
},
"metadata_manifest_sha256": "<string>",
"metadata_release_id": "<string>",
"missing_field_semantics": "turbopuffer",
"object": "<string>",
"search_policy_ids": [
"<string>"
],
"$schema": "https://example.com/schemas/HomologyFilterSchema.json"
},
"ranking": {
"comparability": "within_query_only",
"order": "ascending",
"primary_measurement": "maxsim.bidirectional",
"scope": "resolved_policy_frontier",
"tie_breakers": [
{
"field": "maxsim.bidirectional",
"order": "ascending"
}
]
},
"unavailable_reason": "<string>"
},
"id": "<string>",
"object": "homology_database_release",
"record_count": 1,
"residue_count": 1,
"status": "available",
"compiler_version": "<string>",
"corpus_published_at": "2023-11-07T05:31:56Z",
"manifest_sha256": "<string>"
}
],
"list_metadata": {
"after": "<string>",
"before": "<string>"
},
"object": "list",
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/HomologyDatabaseReleaseList.json"
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}Authorizations
Headers
Query Parameters
Response
OK
⌘I