Create a durable batch of independent homology searches

curl --request POST \
  --url https://api.rafflesia.ai/v1/homology/batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "data": [
    {
      "query": {
        "kind": "protein_sequence",
        "sequence": "<string>"
      },
      "results": {
        "max_results": 5000,
        "significance_requirement": "not_requested",
        "unit": "target"
      },
      "target": {
        "database": "<string>",
        "filter": {
          "filters": [
            "<unknown>"
          ],
          "op": "and",
          "field": "<string>",
          "filter": "<unknown>",
          "value": "<string>",
          "values": [
            "<string>"
          ]
        },
        "release_id": "<string>"
      },
      "constraints": {
        "deadline_ms": 2,
        "max_billable_units": 2
      },
      "policy": {
        "id": "<string>"
      }
    }
  ],
  "max_concurrency": 8
}
'

import requests

url = "https://api.rafflesia.ai/v1/homology/batches"

payload = {
    "data": [
        {
            "query": {
                "kind": "protein_sequence",
                "sequence": "<string>"
            },
            "results": {
                "max_results": 5000,
                "significance_requirement": "not_requested",
                "unit": "target"
            },
            "target": {
                "database": "<string>",
                "filter": {
                    "filters": ["<unknown>"],
                    "op": "and",
                    "field": "<string>",
                    "filter": "<unknown>",
                    "value": "<string>",
                    "values": ["<string>"]
                },
                "release_id": "<string>"
            },
            "constraints": {
                "deadline_ms": 2,
                "max_billable_units": 2
            },
            "policy": { "id": "<string>" }
        }
    ],
    "max_concurrency": 8
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    data: [
      {
        query: {kind: 'protein_sequence', sequence: '<string>'},
        results: {max_results: 5000, significance_requirement: 'not_requested', unit: 'target'},
        target: {
          database: '<string>',
          filter: {
            filters: ['<unknown>'],
            op: 'and',
            field: '<string>',
            filter: '<unknown>',
            value: '<string>',
            values: ['<string>']
          },
          release_id: '<string>'
        },
        constraints: {deadline_ms: 2, max_billable_units: 2},
        policy: {id: '<string>'}
      }
    ],
    max_concurrency: 8
  })
};

fetch('https://api.rafflesia.ai/v1/homology/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rafflesia.ai/v1/homology/batches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        [
                'query' => [
                                'kind' => 'protein_sequence',
                                'sequence' => '<string>'
                ],
                'results' => [
                                'max_results' => 5000,
                                'significance_requirement' => 'not_requested',
                                'unit' => 'target'
                ],
                'target' => [
                                'database' => '<string>',
                                'filter' => [
                                                                'filters' => [
                                                                                                                                '<unknown>'
                                                                ],
                                                                'op' => 'and',
                                                                'field' => '<string>',
                                                                'filter' => '<unknown>',
                                                                'value' => '<string>',
                                                                'values' => [
                                                                                                                                '<string>'
                                                                ]
                                ],
                                'release_id' => '<string>'
                ],
                'constraints' => [
                                'deadline_ms' => 2,
                                'max_billable_units' => 2
                ],
                'policy' => [
                                'id' => '<string>'
                ]
        ]
    ],
    'max_concurrency' => 8
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rafflesia.ai/v1/homology/batches"

	payload := strings.NewReader("{\n  \"data\": [\n    {\n      \"query\": {\n        \"kind\": \"protein_sequence\",\n        \"sequence\": \"<string>\"\n      },\n      \"results\": {\n        \"max_results\": 5000,\n        \"significance_requirement\": \"not_requested\",\n        \"unit\": \"target\"\n      },\n      \"target\": {\n        \"database\": \"<string>\",\n        \"filter\": {\n          \"filters\": [\n            \"<unknown>\"\n          ],\n          \"op\": \"and\",\n          \"field\": \"<string>\",\n          \"filter\": \"<unknown>\",\n          \"value\": \"<string>\",\n          \"values\": [\n            \"<string>\"\n          ]\n        },\n        \"release_id\": \"<string>\"\n      },\n      \"constraints\": {\n        \"deadline_ms\": 2,\n        \"max_billable_units\": 2\n      },\n      \"policy\": {\n        \"id\": \"<string>\"\n      }\n    }\n  ],\n  \"max_concurrency\": 8\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.rafflesia.ai/v1/homology/batches")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {\n      \"query\": {\n        \"kind\": \"protein_sequence\",\n        \"sequence\": \"<string>\"\n      },\n      \"results\": {\n        \"max_results\": 5000,\n        \"significance_requirement\": \"not_requested\",\n        \"unit\": \"target\"\n      },\n      \"target\": {\n        \"database\": \"<string>\",\n        \"filter\": {\n          \"filters\": [\n            \"<unknown>\"\n          ],\n          \"op\": \"and\",\n          \"field\": \"<string>\",\n          \"filter\": \"<unknown>\",\n          \"value\": \"<string>\",\n          \"values\": [\n            \"<string>\"\n          ]\n        },\n        \"release_id\": \"<string>\"\n      },\n      \"constraints\": {\n        \"deadline_ms\": 2,\n        \"max_billable_units\": 2\n      },\n      \"policy\": {\n        \"id\": \"<string>\"\n      }\n    }\n  ],\n  \"max_concurrency\": 8\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.rafflesia.ai/v1/homology/batches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": [\n    {\n      \"query\": {\n        \"kind\": \"protein_sequence\",\n        \"sequence\": \"<string>\"\n      },\n      \"results\": {\n        \"max_results\": 5000,\n        \"significance_requirement\": \"not_requested\",\n        \"unit\": \"target\"\n      },\n      \"target\": {\n        \"database\": \"<string>\",\n        \"filter\": {\n          \"filters\": [\n            \"<unknown>\"\n          ],\n          \"op\": \"and\",\n          \"field\": \"<string>\",\n          \"filter\": \"<unknown>\",\n          \"value\": \"<string>\",\n          \"values\": [\n            \"<string>\"\n          ]\n        },\n        \"release_id\": \"<string>\"\n      },\n      \"constraints\": {\n        \"deadline_ms\": 2,\n        \"max_billable_units\": 2\n      },\n      \"policy\": {\n        \"id\": \"<string>\"\n      }\n    }\n  ],\n  \"max_concurrency\": 8\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "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": "<string>",
  "data": {
    "created_at": "<string>",
    "data": [
      {
        "index": 123,
        "failure": {
          "code": "<string>",
          "detail": "<string>",
          "is_retryable": true
        },
        "search": {
          "created_at": "<string>",
          "expires_at": "<string>",
          "id": "<string>",
          "idempotency_key_expires_at": "<string>",
          "object": "<string>",
          "policy_id": "<string>",
          "query": {
            "kind": "<string>",
            "normalization_id": "<string>",
            "normalized_length": 123,
            "retention": "<string>",
            "sha256": "<string>"
          },
          "receipt": {
            "corpus_snapshot_id": "<string>",
            "database_release_id": "<string>",
            "engine": "<string>",
            "execution_warnings": [
              "<string>"
            ],
            "is_deterministic": true,
            "is_exhaustive": true,
            "is_policy_complete": true,
            "quality_evaluation_ids": [
              "<string>"
            ],
            "search_policy_id": "<string>",
            "semantic_profile_id": "<string>",
            "blueprint_capability_version": "<string>",
            "blueprint_sha256": "<string>",
            "calibration_id": "<string>",
            "canonical_filter_sha256": "<string>",
            "database_residue_count": 1,
            "database_target_count": 1,
            "engine_release": "<string>",
            "execution_receipt_bytes": 1,
            "execution_receipt_id": "<string>",
            "execution_receipt_sha256": "<string>",
            "filter_schema_id": "<string>",
            "job_id": "<string>",
            "query_bundle_id": "<string>",
            "query_compilation_id": "<string>",
            "result_sha256": "<string>",
            "searched_residue_count": 1,
            "searched_target_count": 1,
            "semantic_profile_family_id": "<string>",
            "semantic_profile_manifest_sha256": "<string>",
            "submission_id": "<string>",
            "target_bundle_id": "<string>",
            "target_space_id": "<string>",
            "usage": {
              "logical_bytes_returned": 1,
              "billable_formula_id": "<string>",
              "billable_units": 1,
              "logical_bytes_read": 1,
              "object_reads": 1,
              "query_pack_bytes": 1
            },
            "work": {
              "returned_result_count": 1,
              "affine_cells": 1,
              "affine_pairs": 1,
              "candidate_pairs": 1,
              "maxsim_residue_pairs": 1,
              "traceback_pairs": 1
            }
          },
          "results": {
            "max_results": 5000,
            "significance_requirement": "not_requested",
            "unit": "target"
          },
          "retention_class": "standard_30d",
          "specification_sha256": "<string>",
          "warnings": [
            {
              "code": "<string>",
              "message": "<string>",
              "details": {}
            }
          ],
          "failure": {
            "code": "<string>",
            "detail": "<string>",
            "is_retryable": true
          },
          "result_set": {
            "canonical_result_id": "<string>",
            "count": 123,
            "expires_at": "<string>",
            "is_result_limit_reached": true,
            "object": "<string>",
            "sha256": "<string>",
            "url": "<string>"
          },
          "target_space": {
            "eligible_record_count": 123,
            "eligible_residue_count": 123,
            "id": "<string>",
            "is_filtered": true,
            "total_record_count": 123,
            "unknown_record_count": 123,
            "canonical_filter_sha256": "<string>",
            "filter_schema_id": "<string>"
          }
        }
      }
    ],
    "expires_at": "<string>",
    "id": "<string>",
    "idempotency_key_expires_at": "<string>",
    "object": "homology_batch",
    "retention_class": "standard_30d"
  },
  "error": {
    "code": "<string>",
    "doc_url": "<string>",
    "message": "<string>",
    "details": {},
    "param": "<string>"
  },
  "evidence": {
    "warnings_count": 123,
    "duration_ms": 123,
    "input_refs": [
      "<string>"
    ],
    "object_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "row_count": 123
  }
}

{
  "ok": true,
  "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": "<string>",
  "data": {
    "created_at": "<string>",
    "data": [
      {
        "index": 123,
        "failure": {
          "code": "<string>",
          "detail": "<string>",
          "is_retryable": true
        },
        "search": {
          "created_at": "<string>",
          "expires_at": "<string>",
          "id": "<string>",
          "idempotency_key_expires_at": "<string>",
          "object": "<string>",
          "policy_id": "<string>",
          "query": {
            "kind": "<string>",
            "normalization_id": "<string>",
            "normalized_length": 123,
            "retention": "<string>",
            "sha256": "<string>"
          },
          "receipt": {
            "corpus_snapshot_id": "<string>",
            "database_release_id": "<string>",
            "engine": "<string>",
            "execution_warnings": [
              "<string>"
            ],
            "is_deterministic": true,
            "is_exhaustive": true,
            "is_policy_complete": true,
            "quality_evaluation_ids": [
              "<string>"
            ],
            "search_policy_id": "<string>",
            "semantic_profile_id": "<string>",
            "blueprint_capability_version": "<string>",
            "blueprint_sha256": "<string>",
            "calibration_id": "<string>",
            "canonical_filter_sha256": "<string>",
            "database_residue_count": 1,
            "database_target_count": 1,
            "engine_release": "<string>",
            "execution_receipt_bytes": 1,
            "execution_receipt_id": "<string>",
            "execution_receipt_sha256": "<string>",
            "filter_schema_id": "<string>",
            "job_id": "<string>",
            "query_bundle_id": "<string>",
            "query_compilation_id": "<string>",
            "result_sha256": "<string>",
            "searched_residue_count": 1,
            "searched_target_count": 1,
            "semantic_profile_family_id": "<string>",
            "semantic_profile_manifest_sha256": "<string>",
            "submission_id": "<string>",
            "target_bundle_id": "<string>",
            "target_space_id": "<string>",
            "usage": {
              "logical_bytes_returned": 1,
              "billable_formula_id": "<string>",
              "billable_units": 1,
              "logical_bytes_read": 1,
              "object_reads": 1,
              "query_pack_bytes": 1
            },
            "work": {
              "returned_result_count": 1,
              "affine_cells": 1,
              "affine_pairs": 1,
              "candidate_pairs": 1,
              "maxsim_residue_pairs": 1,
              "traceback_pairs": 1
            }
          },
          "results": {
            "max_results": 5000,
            "significance_requirement": "not_requested",
            "unit": "target"
          },
          "retention_class": "standard_30d",
          "specification_sha256": "<string>",
          "warnings": [
            {
              "code": "<string>",
              "message": "<string>",
              "details": {}
            }
          ],
          "failure": {
            "code": "<string>",
            "detail": "<string>",
            "is_retryable": true
          },
          "result_set": {
            "canonical_result_id": "<string>",
            "count": 123,
            "expires_at": "<string>",
            "is_result_limit_reached": true,
            "object": "<string>",
            "sha256": "<string>",
            "url": "<string>"
          },
          "target_space": {
            "eligible_record_count": 123,
            "eligible_residue_count": 123,
            "id": "<string>",
            "is_filtered": true,
            "total_record_count": 123,
            "unknown_record_count": 123,
            "canonical_filter_sha256": "<string>",
            "filter_schema_id": "<string>"
          }
        }
      }
    ],
    "expires_at": "<string>",
    "id": "<string>",
    "idempotency_key_expires_at": "<string>",
    "object": "homology_batch",
    "retention_class": "standard_30d"
  },
  "error": {
    "code": "<string>",
    "doc_url": "<string>",
    "message": "<string>",
    "details": {},
    "param": "<string>"
  },
  "evidence": {
    "warnings_count": 123,
    "duration_ms": 123,
    "input_refs": [
      "<string>"
    ],
    "object_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "row_count": 123
  }
}

{
  "ok": true,
  "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": "<string>",
  "data": {
    "created_at": "<string>",
    "data": [
      {
        "index": 123,
        "failure": {
          "code": "<string>",
          "detail": "<string>",
          "is_retryable": true
        },
        "search": {
          "created_at": "<string>",
          "expires_at": "<string>",
          "id": "<string>",
          "idempotency_key_expires_at": "<string>",
          "object": "<string>",
          "policy_id": "<string>",
          "query": {
            "kind": "<string>",
            "normalization_id": "<string>",
            "normalized_length": 123,
            "retention": "<string>",
            "sha256": "<string>"
          },
          "receipt": {
            "corpus_snapshot_id": "<string>",
            "database_release_id": "<string>",
            "engine": "<string>",
            "execution_warnings": [
              "<string>"
            ],
            "is_deterministic": true,
            "is_exhaustive": true,
            "is_policy_complete": true,
            "quality_evaluation_ids": [
              "<string>"
            ],
            "search_policy_id": "<string>",
            "semantic_profile_id": "<string>",
            "blueprint_capability_version": "<string>",
            "blueprint_sha256": "<string>",
            "calibration_id": "<string>",
            "canonical_filter_sha256": "<string>",
            "database_residue_count": 1,
            "database_target_count": 1,
            "engine_release": "<string>",
            "execution_receipt_bytes": 1,
            "execution_receipt_id": "<string>",
            "execution_receipt_sha256": "<string>",
            "filter_schema_id": "<string>",
            "job_id": "<string>",
            "query_bundle_id": "<string>",
            "query_compilation_id": "<string>",
            "result_sha256": "<string>",
            "searched_residue_count": 1,
            "searched_target_count": 1,
            "semantic_profile_family_id": "<string>",
            "semantic_profile_manifest_sha256": "<string>",
            "submission_id": "<string>",
            "target_bundle_id": "<string>",
            "target_space_id": "<string>",
            "usage": {
              "logical_bytes_returned": 1,
              "billable_formula_id": "<string>",
              "billable_units": 1,
              "logical_bytes_read": 1,
              "object_reads": 1,
              "query_pack_bytes": 1
            },
            "work": {
              "returned_result_count": 1,
              "affine_cells": 1,
              "affine_pairs": 1,
              "candidate_pairs": 1,
              "maxsim_residue_pairs": 1,
              "traceback_pairs": 1
            }
          },
          "results": {
            "max_results": 5000,
            "significance_requirement": "not_requested",
            "unit": "target"
          },
          "retention_class": "standard_30d",
          "specification_sha256": "<string>",
          "warnings": [
            {
              "code": "<string>",
              "message": "<string>",
              "details": {}
            }
          ],
          "failure": {
            "code": "<string>",
            "detail": "<string>",
            "is_retryable": true
          },
          "result_set": {
            "canonical_result_id": "<string>",
            "count": 123,
            "expires_at": "<string>",
            "is_result_limit_reached": true,
            "object": "<string>",
            "sha256": "<string>",
            "url": "<string>"
          },
          "target_space": {
            "eligible_record_count": 123,
            "eligible_residue_count": 123,
            "id": "<string>",
            "is_filtered": true,
            "total_record_count": 123,
            "unknown_record_count": 123,
            "canonical_filter_sha256": "<string>",
            "filter_schema_id": "<string>"
          }
        }
      }
    ],
    "expires_at": "<string>",
    "id": "<string>",
    "idempotency_key_expires_at": "<string>",
    "object": "homology_batch",
    "retention_class": "standard_30d"
  },
  "error": {
    "code": "<string>",
    "doc_url": "<string>",
    "message": "<string>",
    "details": {},
    "param": "<string>"
  },
  "evidence": {
    "warnings_count": 123,
    "duration_ms": 123,
    "input_refs": [
      "<string>"
    ],
    "object_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "row_count": 123
  }
}

{
  "$schema": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}