Term List
API endpoint that allows CV Terms to be viewed or edited.
» click to learn about Filtering, Ordering and more...
Accepted filters:
- search: Search in the following fields: ^name, ^description. (^startswith, $regex, =exact)
- id: ID (exact)
- created: Created (exact)
- modified: Modified (exact)
- name: Name starts with (istartswith)
- description: Description contains (icontains)
- autocomplete: Autocomplete filter on the name property (exact)
- owner: Owner Username (exact)
- owned_by: Filter on list of owned by group names [OR] (exact)
- public: Public (exact)
- deleted: Deleted (exact)
- deleted_by: Deleted by (exact)
- deleted_date: Deleted date (exact)
- default: Default (exact)
- category__name: Category Name (exact)
- category__id: Category ID (exact)
- created_by: Created by Username (exact)
- modified_by: Modified by Username (exact)
- dbxref_id: DBXRef ID (exact)
- category_name: Filter on category name (exact)
- category: Filter by category id (exact)
- category_id: Filter by category id (exact)
- category_id_list: Filter on list of category ids [OR] (exact)
- category_name_list: Filter on list of category names [OR] (exact)
» more..
- property: A property for which we need to retrieve the available terms, can be a name or uuid
- dependencies: a json dict that has the values for the properties the given property depends on:
{"chemical_risk_code": "R1", "<uuid>": "H1"}
- intersect: default False, Intersect on the given filter values instead of doing a "ANY" lookup
- scope(_id): (multiple) name or uuid of one or more Scopes.
- scope_tag(_id): (multiple) name or uuid of one or more Scope Tags.
Multiple scopes or scope tags are given like so: scope=Scope1&scope=Scope2
Advanced Filtering
You can also filter using a json object to process all search parameters. Currently this filter supports the syntax as produced/used by the http://summitroute.github.io/react-structured-filter/ search UI.
Example
?query={"category":"name","operator":"contains","value":"Y00"},
{"category":"amount","operator":">","value":"10"},
{"category":"type__name","operator":"exact","value":"ANTIBODY"}
» more info about the query param..
Preset mappings
- category: category__name
- deleted: <function filter_deleted at 0x7f8cbd71a440>
- deleted_by: deleted_by__username
- owner: owner__username
- owned_by: owned_by__name
- created_by: created_by__username
- modified_by: modified_by__username
Operators
- ==
- =
- >=
- >
- <=
- <
- contains
- icontains
- exact
- iexact
- startswith
- istartswith
- endswith
- iendswith
Permission filtering
Based on the current logged in user you can filter for objects that have a particular permission set:
- can_change: True/False, show objects that you can change
- can_delete: True/False, show objects that you can delete
# not applicable - will raise NotAcceptable:
- can_view: as this is always True, you can only view items you are allowed to see
Ordering
You can order on practically any field even spanning relations.
# reverse order on owner username
?ordering=-owner
# order on related field
?ordering=category__version
API endpoint that allows CV Terms to be viewed or edited.
<details>
<summary>
<i> » click to learn about Filtering, Ordering and more...</i>
</summary>
<details>
<summary> » more..</summary>
```
- property: A property for which we need to retrieve the available terms, can be a name or uuid
- dependencies: a json dict that has the values for the properties the given property depends on:
{"chemical_risk_code": "R1", "<uuid>": "H1"}
- intersect: default False, Intersect on the given filter values instead of doing a "ANY" lookup
- scope(_id): (multiple) name or uuid of one or more Scopes.
- scope_tag(_id): (multiple) name or uuid of one or more Scope Tags.
Multiple scopes or scope tags are given like so: scope=Scope1&scope=Scope2
```
</details>
</details>
None
The default modelviewset used in this project
Add JSONPatch like functionality to bulk update items.
### Bulk Delete
This view also allows for one to bulk delete items. The url needs to be appended by ``/bulk_delete/`` and the ids
need to be given by multiple query_params:
```
{current_url}/bulk_delete/?id=<id_1>,id=<id_2>
```
GET /api/v2/vocabularies/terms/?format=api&ordering=deleted&page=4
{ "previous": "https://labid-demo.embl.de/api/v2/vocabularies/terms/?format=api&ordering=deleted&page=3", "next": "https://labid-demo.embl.de/api/v2/vocabularies/terms/?format=api&ordering=deleted&page=5", "current": 4, "total": 618, "total_pages": 124, "results": [ { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/vocabularies/terms/55dcf894-9ac6-4a03-97ce-e0a3db320161/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "55dcf894-9ac6-4a03-97ce-e0a3db320161" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "created": { "name": "created", "value": "2025-02-18T21:41:16.968144+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-02-18T21:41:16.970380+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "term" }, "app_name": { "name": "app_name", "category": "property", "value": "vocabularies" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "55dcf894-9ac6-4a03-97ce-e0a3db320161", "name": "mouse embryonic stem cells", "model_name": "term", "app_name": "vocabularies", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "mouse embryonic stem cells" }, "description": { "name": "description", "category": "property", "value": "mouse embryonic stem cells (CLO:0037317)" }, "label": { "name": "label", "category": "property", "value": "mouse embryonic stem cells (mouse embryonic stem cells (CLO:0037317))" }, "short_name": { "name": "short_name", "category": "property", "value": "mouse embryonic stem cells" }, "image_url": { "name": "image_url", "category": "property", "value": "" }, "category": { "name": "category", "value": { "id": "26307f3b-df6a-46c3-8999-31b8ccd493b6", "name": "celltypes", "label": "Celltypes", "deleted": false, "model_name": "category", "app_name": "vocabularies", "model_type": "DEFAULT" }, "category": "property" }, "dbxref_id": { "name": "dbxref_id", "category": "property", "value": "CLO:0037317" }, "default": { "name": "default", "category": "property", "value": false }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "owner": { "name": "owner", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/vocabularies/terms/8fa6f68e-29d6-4771-9509-f021f5ed0b57/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "8fa6f68e-29d6-4771-9509-f021f5ed0b57" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "created": { "name": "created", "value": "2025-02-18T21:41:17.014598+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-02-18T21:41:17.016462+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "term" }, "app_name": { "name": "app_name", "category": "property", "value": "vocabularies" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "8fa6f68e-29d6-4771-9509-f021f5ed0b57", "name": "human embryonic stem cells", "model_name": "term", "app_name": "vocabularies", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "human embryonic stem cells" }, "description": { "name": "description", "category": "property", "value": "human embryonic stem cells (CLO:0037280)" }, "label": { "name": "label", "category": "property", "value": "human embryonic stem cells (human embryonic stem cells (CLO:0037280))" }, "short_name": { "name": "short_name", "category": "property", "value": "human embryonic stem cells" }, "image_url": { "name": "image_url", "category": "property", "value": "" }, "category": { "name": "category", "value": { "id": "26307f3b-df6a-46c3-8999-31b8ccd493b6", "name": "celltypes", "label": "Celltypes", "deleted": false, "model_name": "category", "app_name": "vocabularies", "model_type": "DEFAULT" }, "category": "property" }, "dbxref_id": { "name": "dbxref_id", "category": "property", "value": "CLO:0037280" }, "default": { "name": "default", "category": "property", "value": false }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "owner": { "name": "owner", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/vocabularies/terms/67a926ae-0e57-48c0-a946-056b3b2966ee/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "67a926ae-0e57-48c0-a946-056b3b2966ee" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "created": { "name": "created", "value": "2025-02-18T21:41:17.051684+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-02-18T21:41:17.053355+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "term" }, "app_name": { "name": "app_name", "category": "property", "value": "vocabularies" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "67a926ae-0e57-48c0-a946-056b3b2966ee", "name": "HeLa", "model_name": "term", "app_name": "vocabularies", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "HeLa" }, "description": { "name": "description", "category": "property", "value": "HeLa cells were developed from cervix adenocarcinoma of a 31-year-old Black female. The cells are positive for keratin by immunoperoxidase staining. HeLa cells have been reported to contain human papilloma virus 18 (HPV-18) sequences. P53 expression was reported to be low, and normal levels of pRB (retinoblastoma suppressor) were found. Four typical HeLa marker chromosomes have been reported. M1 is a rearranged long arm and centromere of chromosome 1 and the long arm of chromosome 3. M2 is a combination of short arm of chromosome 3 and long arm of chromosome 5. M3 is an isochromosome of the short arm of chromosome 5. M4 consists of the long arm of chromosome 11 and an arm of chromosome 19. HeLa Marker Chromosomes: One copy of Ml, one copy of M2, four-five copies of M3, and two copies of M4 as revealed by G-banding patterns." }, "label": { "name": "label", "category": "property", "value": "HeLa (HeLa cells were developed from cervix adenocarcinoma of a 31-year-old Black female. The cells are positive for keratin by immunoperoxidase staining. HeLa cells have been reported to contain human papilloma virus 18 (HPV-18) sequences. P53 expression was reported to be low, and normal levels of pRB (retinoblastoma suppressor) were found. Four typical HeLa marker chromosomes have been reported. M1 is a rearranged long arm and centromere of chromosome 1 and the long arm of chromosome 3. M2 is a combination of short arm of chromosome 3 and long arm of chromosome 5. M3 is an isochromosome of the short arm of chromosome 5. M4 consists of the long arm of chromosome 11 and an arm of chromosome 19. HeLa Marker Chromosomes: One copy of Ml, one copy of M2, four-five copies of M3, and two copies of M4 as revealed by G-banding patterns.)" }, "short_name": { "name": "short_name", "category": "property", "value": "HeLa" }, "image_url": { "name": "image_url", "category": "property", "value": "" }, "category": { "name": "category", "value": { "id": "26307f3b-df6a-46c3-8999-31b8ccd493b6", "name": "celltypes", "label": "Celltypes", "deleted": false, "model_name": "category", "app_name": "vocabularies", "model_type": "DEFAULT" }, "category": "property" }, "dbxref_id": { "name": "dbxref_id", "category": "property", "value": "NCIT:C20226" }, "default": { "name": "default", "category": "property", "value": false }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "owner": { "name": "owner", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/vocabularies/terms/a4e32a0d-447a-48ed-b3b0-d6c611155951/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "a4e32a0d-447a-48ed-b3b0-d6c611155951" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "created": { "name": "created", "value": "2025-02-18T21:41:17.136172+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-02-18T21:41:17.138010+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "term" }, "app_name": { "name": "app_name", "category": "property", "value": "vocabularies" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "a4e32a0d-447a-48ed-b3b0-d6c611155951", "name": "g/L", "model_name": "term", "app_name": "vocabularies", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "g/L" }, "description": { "name": "description", "category": "property", "value": "Mass per volume" }, "label": { "name": "label", "category": "property", "value": "g/L (Mass per volume)" }, "short_name": { "name": "short_name", "category": "property", "value": "g/L" }, "image_url": { "name": "image_url", "category": "property", "value": "" }, "category": { "name": "category", "value": { "id": "413a9187-c7f7-471a-903a-48187cb6e812", "name": "concentration_units", "label": "Concentration units", "deleted": false, "model_name": "category", "app_name": "vocabularies", "model_type": "DEFAULT" }, "category": "property" }, "dbxref_id": { "name": "dbxref_id", "category": "property", "value": "" }, "default": { "name": "default", "category": "property", "value": false }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "owner": { "name": "owner", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/vocabularies/terms/04f26bfd-124e-4090-a3fb-f3e659eafb6a/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "04f26bfd-124e-4090-a3fb-f3e659eafb6a" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "created": { "name": "created", "value": "2025-02-18T21:41:16.320041+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-02-18T21:41:16.323837+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "term" }, "app_name": { "name": "app_name", "category": "property", "value": "vocabularies" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "04f26bfd-124e-4090-a3fb-f3e659eafb6a", "name": "unknown", "model_name": "term", "app_name": "vocabularies", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "unknown" }, "description": { "name": "description", "category": "property", "value": "" }, "label": { "name": "label", "category": "property", "value": "unknown" }, "short_name": { "name": "short_name", "category": "property", "value": "unknown" }, "image_url": { "name": "image_url", "category": "property", "value": "" }, "category": { "name": "category", "value": { "id": "a07b15f3-8e56-4c15-96c8-21cc048dc528", "name": "species", "label": "Species", "deleted": false, "model_name": "category", "app_name": "vocabularies", "model_type": "DEFAULT" }, "category": "property" }, "dbxref_id": { "name": "dbxref_id", "category": "property", "value": "unknown" }, "default": { "name": "default", "category": "property", "value": true }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "owner": { "name": "owner", "value": { "id": 2, "username": "admin", "full_name": "admin" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" } } ] }