How to register a cell line in hPSCreg, creating a name
You can create a name for a cell line by sending JSON data to:
POST
https://hpscreg.eu/api/cell-line/name
The result is the hPSCreg name of the created cell line in plain text. See the Nomenclature for the structure of hPSCreg names.
You need to authenticate with an hPSCreg user account via HTTP Auth. Please don't create lines just for an API test. You can either use the preview or use the test server first.
The fields of the create_name request JSON are:
The optional fields don't have to be included in every request, but they have to be included every time where they are applicable.
Examples
An hiPSC line generated by provider TEST with no other line from the same donor in hPSCreg can be registered like this:
{
"provider": "TEST",
"type": "i",
"alternative_names": ["x123"],
"comment": "this is that one special line"
}
Cell lines which are genetically modified are subclones. In that case the unmodified clone needs to be registered on hPSCreg first (either manually or with the API). Let the hPSCreg name of the unmodified clone be TESTi006-A. The subclone can then be registered like that:
{
"provider": "TEST",
"type": "i",
"subclone_of": "TESTi006-A",
"alternative_names": ["x456"],
"comment": "x123 with that special modification"
}
Note that the same_donor is not used, even though the subclone also has the same donor as the unmodified clone.
A cell line that has the same donor as TESTi006-A, but is not a subclone, can be registered like that:
{
"provider": "TEST",
"type": "i",
"same_donor": "TESTi006-A",
"alternative_names": ["x789", "y007"],
"comment": "a line of that special donor"
}
The order of registration for lines from the same donor can be arbitrary, but names reflect that order.
Comments and alternative names are not required, but should be provided if possible. You can provide multiple alternative names.