Ekayana Documentation

# No SDK to install. The API is plain HTTP/JSON.
# Sign in once and use the token on every request.
curl -X POST https://api.ekayana.io/api/signin \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@lab.example", "password": "..." }'
# -> { "token": "..." }

// Upload research data. The CID comes back immediately
const body = new FormData();
body.append('file', file); // e.g. dataset.csv

const res = await fetch('https://api.ekayana.io/api/upload', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body,
});

const { cid } = await res.json();
// The CID names the sealed envelope, so every upload gets a new one.

// Mint a did:bio identifier for a dataset
const res = await fetch('https://api.ekayana.io/api/did', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    kind: 'dataset',
    metadata: {
      title: 'Coral bleaching survey 2026',
      researchers: [{ name: 'Ada Lovelace', role: 'PI' }],
      keywords: ['coral', 'bleaching'],
      license: 'CC-BY-4.0',
    },
  }),
});

// anchored: false until your wallet signs the anchor workflow
const record = await res.json();

// Register an uploaded paper with BioAgents
const res = await fetch('https://api.ekayana.io/api/research-paper', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    file_cid: 'bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi',
    title: 'CRISPR-Cas9 Gene Editing for Neurodegenerative Diseases',
    authors: ['Jane Smith', 'John Doe'],
    doi: '10.1038/s41586-021-03819-2',
  }),
});

// Ingestion runs in the background. Poll the paper record for its status
const { did, status } = await res.json();