Lineage

POST/api/v1/lineage/breed

Breed

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?|

Idempotency key to make the breeding request retry-safe

parents*array<string>

Parent entity ids

seed?|

Optional deterministic seed; if omitted, a server seed is committed

species_id*string

Species the parents belong to

`application/json`

curl -X POST "https://example.com/api/v1/lineage/breed" \  -H "Content-Type: application/json" \  -d '{    "parents": [      "string"    ],    "species_id": "string"  }'

{  "created_at": "2019-08-24T14:15:22Z",  "mutations": [    "string"  ],  "offspring": [    {      "anchor_artifact_id": "string",      "anchor_hash": "string",      "entity_id": "string",      "generation": 0,      "inbreeding_coefficient": 0.1    }  ],  "parents": [    "string"  ],  "record_id": "string",  "requested_by": "string",  "seed": "string",  "species_id": "string",  "species_version": 0}

GET/api/v1/lineage/entities/{entity_id}/genome

Get_genome

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Query Parameters

full?boolean

Reveal hidden genes and raw alleles (admin only)

`application/json`

curl -X GET "https://example.com/api/v1/lineage/entities/string/genome"

{  "breeding_count": 0,  "entity_id": "string",  "expressed": {    "property1": "string",    "property2": "string"  },  "flags": [    "string"  ],  "generation": 0,  "numeric": {    "property1": 0.1,    "property2": 0.1  },  "owner": "string",  "raw_alleles": {    "property1": {      "first": "string",      "second": "string"    },    "property2": {      "first": "string",      "second": "string"    }  },  "species_id": "string"}

GET/api/v1/lineage/entities/{entity_id}/pedigree

Get_pedigree

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Query Parameters

depth?integer

Ancestry depth to traverse

Formatint32

Range0 <= value

`application/json`

curl -X GET "https://example.com/api/v1/lineage/entities/string/pedigree"

{  "ancestors": [    {      "distance": 0,      "entity_id": "string",      "generation": 0    }  ],  "entity_id": "string",  "generation": 0,  "inbreeding_coefficient": 0}

GET/api/v1/lineage/entities/{entity_id}/provenance

List_records

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Conditions as filter[][]=. Conditions on different fields all apply. in (any of) and all (every one of, on fields holding several values) take a comma-separated list (\, for a literal comma). exists takes true or false. Datetimes are RFC 3339, now, or a time before now such as -30m, -6h or -7d.

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: species_version, created_at. Default: -created_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/lineage/records"

{  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "records": [    {      "created_at": "2019-08-24T14:15:22Z",      "mutations": [        "string"      ],      "offspring": [        {          "anchor_artifact_id": "string",          "anchor_hash": "string",          "entity_id": "string",          "generation": 0,          "inbreeding_coefficient": 0.1        }      ],      "parents": [        "string"      ],      "record_id": "string",      "requested_by": "string",      "species_id": "string",      "species_version": 0    }  ]}

GET/api/v1/lineage/species

List_species

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Query Parameters

filter?

q?string

Full-text search over this list's searchable fields.

Length1 <= length <= 200

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: name, version, created_at. Default: -created_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/lineage/species"

{  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "species": [    {      "compatibility": {        "min_generation": 0,        "required_flags": [          "string"        ],        "self_compatible": true      },      "created_at": "2019-08-24T14:15:22Z",      "created_by": "string",      "lineage": {        "inbreeding": {          "compute": true,          "max_coefficient": 0.1,          "penalties_enabled": true        },        "track_generations": true      },      "max_lifetime_breedings": 0,      "name": "string",      "parent_count": {        "max": 0,        "min": 0      },      "preview_quantization": {        "bands": 0      },      "species_id": "string",      "traits": [        "string"      ],      "updated_at": "2019-08-24T14:15:22Z",      "version": 0    }  ]}

POST/api/v1/lineage/species

Create_species

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

compatibility?

Compatibility rules

lineage?

Lineage and inbreeding policy

max_lifetime_breedings?integer

Maximum lifetime breedings per parent (0 = unlimited)

Formatint32

Range0 <= value

name*string

Human-readable species name

parent_count*

Allowed parent count window

preview_quantization?

Per-species preview quantization for player-facing previews

traits?array<string>

Trait ids that make up this species' genome

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/lineage/species" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "parent_count": {      "max": 0,      "min": 0    }  }'

{  "compatibility": {    "min_generation": 0,    "required_flags": [      "string"    ],    "self_compatible": true  },  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "lineage": {    "inbreeding": {      "compute": true,      "max_coefficient": 0.1,      "penalties_enabled": true    },    "track_generations": true  },  "max_lifetime_breedings": 0,  "name": "string",  "parent_count": {    "max": 0,    "min": 0  },  "preview_quantization": {    "bands": 0  },  "species_id": "string",  "traits": [    "string"  ],  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

GET/api/v1/lineage/species/{species_id}

Get_species

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

species_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/lineage/species/string"

{  "compatibility": {    "min_generation": 0,    "required_flags": [      "string"    ],    "self_compatible": true  },  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "lineage": {    "inbreeding": {      "compute": true,      "max_coefficient": 0.1,      "penalties_enabled": true    },    "track_generations": true  },  "max_lifetime_breedings": 0,  "name": "string",  "parent_count": {    "max": 0,    "min": 0  },  "preview_quantization": {    "bands": 0  },  "species_id": "string",  "traits": [    "string"  ],  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

DELETE/api/v1/lineage/species/{species_id}

Delete_species

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

species_id*string

Response Body

`application/json`

curl -X DELETE "https://example.com/api/v1/lineage/species/string"

{  "message": "string",  "species_id": "string"}

PUT/api/v1/lineage/species/{species_id}

Update_species

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

species_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

compatibility?null|

lineage?null|

max_lifetime_breedings?|

New lifetime breeding cap

Formatint32

Range0 <= value

name?|

New species name

parent_count?null|

preview_quantization?null|

traits?array<string>|

Replacement trait id list

Response Body

`application/json`

curl -X PUT "https://example.com/api/v1/lineage/species/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "compatibility": {    "min_generation": 0,    "required_flags": [      "string"    ],    "self_compatible": true  },  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "lineage": {    "inbreeding": {      "compute": true,      "max_coefficient": 0.1,      "penalties_enabled": true    },    "track_generations": true  },  "max_lifetime_breedings": 0,  "name": "string",  "parent_count": {    "max": 0,    "min": 0  },  "preview_quantization": {    "bands": 0  },  "species_id": "string",  "traits": [    "string"  ],  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

GET/api/v1/lineage/traits

List_traits

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Query Parameters

filter?

q?string

Full-text search over this list's searchable fields.

Length1 <= length <= 200

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: name, created_at. Default: -created_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/lineage/traits"

{  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "traits": [    {      "alleles": [        {          "carrier_only_visible": true,          "dominance": 0,          "id": "string",          "label": "string"        }      ],      "conflicts_with": [        "string"      ],      "created_at": "2019-08-24T14:15:22Z",      "created_by": "string",      "expression": "highest_dominance",      "hidden": true,      "inheritance": {        "parent_weighting": "equal",        "variance": {          "distribution": "none",          "stddev": 0.1        }      },      "kind": "mendelian",      "mutation": {        "offset_max": 0.1,        "offset_min": 0.1,        "rate": 0.1      },      "name": "string",      "range": null,      "trait_id": "string",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

POST/api/v1/lineage/traits

Create_trait

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

alleles?array<>

Allele set for mendelian traits

conflicts_with?array<string>

Trait ids this trait conflicts with

expression?MendelianExpression

Expression rule for mendelian traits

Value in

"highest_dominance"
"recessive_only"

hidden?boolean

Whether the trait is hidden (present but not expressed until a descendant)

inheritance?

Inheritance settings for numeric traits

kind*TraitKind

Trait kind (mendelian or numeric)

Value in

"mendelian"
"numeric"

mutation?

Mutation specification

name*string

Human-readable trait name

range?null|

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/lineage/traits" \  -H "Content-Type: application/json" \  -d '{    "kind": "mendelian",    "name": "string"  }'

{  "alleles": [    {      "carrier_only_visible": true,      "dominance": 0,      "id": "string",      "label": "string"    }  ],  "conflicts_with": [    "string"  ],  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "expression": "highest_dominance",  "hidden": true,  "inheritance": {    "parent_weighting": "equal",    "variance": {      "distribution": "none",      "stddev": 0.1    }  },  "kind": "mendelian",  "mutation": {    "offset_max": 0.1,    "offset_min": 0.1,    "rate": 0.1  },  "name": "string",  "range": null,  "trait_id": "string",  "updated_at": "2019-08-24T14:15:22Z"}

GET/api/v1/lineage/traits/{trait_id}

Get_trait

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

trait_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/lineage/traits/string"

{  "alleles": [    {      "carrier_only_visible": true,      "dominance": 0,      "id": "string",      "label": "string"    }  ],  "conflicts_with": [    "string"  ],  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "expression": "highest_dominance",  "hidden": true,  "inheritance": {    "parent_weighting": "equal",    "variance": {      "distribution": "none",      "stddev": 0.1    }  },  "kind": "mendelian",  "mutation": {    "offset_max": 0.1,    "offset_min": 0.1,    "rate": 0.1  },  "name": "string",  "range": null,  "trait_id": "string",  "updated_at": "2019-08-24T14:15:22Z"}

DELETE/api/v1/lineage/traits/{trait_id}

Delete_trait

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

trait_id*string

Response Body

`application/json`

curl -X DELETE "https://example.com/api/v1/lineage/traits/string"

{  "message": "string",  "trait_id": "string"}

PUT/api/v1/lineage/traits/{trait_id}

Update_trait

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

trait_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

alleles?array<>|

Replacement allele set

conflicts_with?array<string>|

New conflict list

expression?null|

hidden?|

New hidden flag

inheritance?null|

mutation?null|

name?|

New trait name

range?null|

Response Body

`application/json`

curl -X PUT "https://example.com/api/v1/lineage/traits/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "alleles": [    {      "carrier_only_visible": true,      "dominance": 0,      "id": "string",      "label": "string"    }  ],  "conflicts_with": [    "string"  ],  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "expression": "highest_dominance",  "hidden": true,  "inheritance": {    "parent_weighting": "equal",    "variance": {      "distribution": "none",      "stddev": 0.1    }  },  "kind": "mendelian",  "mutation": {    "offset_max": 0.1,    "offset_min": 0.1,    "rate": 0.1  },  "name": "string",  "range": null,  "trait_id": "string",  "updated_at": "2019-08-24T14:15:22Z"}

Lineage

201application/json

400

403

404

200application/json

403

404

200application/json

404

200application/json

404

201application/json

400

404

200application/json

400

404

200application/json

400

200application/json

400

201application/json

400

403

200application/json

404

200application/json

403

404

200application/json

403

404

200application/json

400

201application/json

400

403

200application/json

404

200application/json

403

404

200application/json

403

404

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`