{"openapi": "3.1.0", "info": {"title": "System REST API", "description": "\nThis page provides documentation for the System REST API.\n\nIf you have any questions or need support, please contact us at the email provided.\n\n## Formatting query parameters\n\nFilters should be formatted as `field:value` and use the logical OR operator `||` to specify an OR condition. (We've deprecated the pipe operator for OR conditions.) \n\nIf they are numerical, they should be formatted as `field:opvalue`. Examples:\n- `doi:10.1234/5678||10.8765/4321`\n- `num_findings:>2`\n\nSorts should be formatted as `field:direction`. Examples:\n- `cited_by:desc`\n- `publish_date:asc`\n\nSearches should be formatted as `field:value`. Examples:\n- `name:osteoporosis`\n", "contact": {"name": "System API Team", "url": "https://systemtechnologies.atlassian.net/servicedesk/customer/portal/4", "email": "api@system.com"}, "version": "0.1.0"}, "servers": [{"url": "https://api-prod.system.com", "description": "Production API"}, {"url": "https://api-stage.system.com", "description": "Staging API"}, {"url": "https://api-dev.system.com", "description": "Development API"}, {"url": "/", "description": "Local API"}], "paths": {"/v0/topics/{topic_id}": {"get": {"tags": ["Topics"], "summary": "Get a topic", "description": "Get a topic by its ID.", "operationId": "get_topic_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Topic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics": {"get": {"tags": ["Topics"], "summary": "Get topics", "description": "Get a list of topics.", "operationId": "get_topics", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, wikidata_id, umls_cuis, category, roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, wikidata_id, umls_cuis, category, roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Topic_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/variables": {"get": {"tags": ["Topics"], "summary": "Get topic variables", "description": "Get a list of the variables that have been matched to a given topic.", "operationId": "get_topic_variables", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_studies.", "default": "num_studies:desc", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_studies."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Variable_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/relationships": {"get": {"tags": ["Topics"], "summary": "Get topic relationships", "description": "Get a list of the relationships that include a given topic as the source or target topic.", "operationId": "get_topic_relationships", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Relationship_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/determinants": {"get": {"tags": ["Topics"], "summary": "Get topic determinants", "description": "Get a list of determinants for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the source topic.", "operationId": "get_topic_determinants", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/interventions": {"get": {"tags": ["Topics"], "summary": "Get topic interventions", "description": "Get a list of interventions for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the source topic.", "operationId": "get_topic_interventions", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/topics/{topic_id}/outcomes": {"get": {"tags": ["Topics"], "summary": "Get topic outcomes", "description": "Get a list of outcomes for a given topic.\nThese are formatted as `TopicPath`s, which include data about the relationship and the target topic.", "operationId": "get_topic_outcomes", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_TopicPath_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies/{study_id}": {"get": {"tags": ["Studies"], "summary": "Get a study", "description": "Get a study by its ID.", "operationId": "get_study_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "study_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Study Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Study"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies": {"get": {"tags": ["Studies"], "summary": "Get studies", "description": "Get a list of studies.", "operationId": "get_studies", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: none.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: none."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Study_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/studies/{study_id}/statistical_findings": {"get": {"tags": ["Studies"], "summary": "Get study statistical findings", "description": "Get a list of the statistical findings reported by a given study.", "operationId": "get_study_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "study_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Study Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings/{finding_id}": {"get": {"tags": ["Statistical Findings"], "summary": "Get a statistical finding", "description": "Get a statistical finding by its ID.", "operationId": "get_statistical_finding_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "finding_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Finding Id"}}], "responses": {"200": {"description": "Statistical Finding object", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/StatisticalFinding"}}}}, "404": {"description": "Not found"}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings": {"get": {"tags": ["Statistical Findings"], "summary": "Get statistical findings", "description": "Get a list of statistical findings.", "operationId": "get_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "List of Statistical Findings", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/statistical_findings/{finding_id}/flags": {"post": {"tags": ["Statistical Findings"], "summary": "Flag statistical finding", "description": "Flag a statistical finding for review.", "operationId": "flag_statistical_finding", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "finding_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Finding Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "array", "items": {"$ref": "#/components/schemas/FlagInput"}, "title": "Flags"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "array", "items": {"$ref": "#/components/schemas/Flag"}, "title": "Response Flag Statistical Finding"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/mechanistic_findings/{finding_id}": {"get": {"tags": ["Mechanistic Findings"], "summary": "Get a mechanistic finding", "description": "Get a mechanistic finding by its ID.", "operationId": "get_mechanistic_finding_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "finding_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Finding Id"}}], "responses": {"200": {"description": "Mechanistic Finding object", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/MechanisticFinding"}}}}, "404": {"description": "Not found"}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/mechanistic_findings": {"get": {"tags": ["Mechanistic Findings"], "summary": "Get mechanistic findings", "description": "Get a list of mechanistic findings.", "operationId": "get_mechanistic_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, mechanism_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, mechanism_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "List of Mechanistic Findings", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_MechanisticFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/variables/{variable_id}": {"get": {"tags": ["Variables"], "summary": "Get a variable", "description": "Get a variable by its ID.", "operationId": "get_variable_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "variable_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Variable Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Variable"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/variables": {"get": {"tags": ["Variables"], "summary": "Get variables", "description": "Get a list of variables.", "operationId": "get_variables", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_studies, topic.id, topic.wikidata_id, topic.umls_cuis, topic.category, topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_studies.", "default": "num_studies:desc", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_studies."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Variable_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/variables/{variable_id}/statistical_findings": {"get": {"tags": ["Variables"], "summary": "Get variable statistical findings", "description": "Get a list of the statistical findings that include a given variable.", "operationId": "get_variable_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "variable_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Variable Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/relationships/{relationship_id}": {"get": {"tags": ["Relationships"], "summary": "Get a relationship", "description": "Get a relationship by its ID.", "operationId": "get_relationship_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "relationship_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Relationship Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Relationship"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/relationships/{relationship_id}/calculations/sign": {"get": {"tags": ["Relationships"], "summary": "[BETA] Get a relationship's sign based on its supporting findings", "description": "Get a relationship sign by its ID.", "operationId": "get_relationship_sign", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "relationship_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Relationship Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Sign"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/relationships": {"get": {"tags": ["Relationships"], "summary": "Get relationships", "description": "Get a list of relationships.", "operationId": "get_relationships", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial, source_topic.id, source_topic.wikidata_id, source_topic.umls_cuis, source_topic.category, source_topic.roles, target_topic.id, target_topic.wikidata_id, target_topic.umls_cuis, target_topic.category, target_topic.roles."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: num_findings, num_studies, num_significant_findings, highest_cited, median_effect_size, last_updated, has_experimental_trial."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: source_topic.name, target_topic.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Relationship_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/relationships/{relationship_id}/studies": {"get": {"tags": ["Relationships"], "summary": "Get relationship studies", "description": "Get a list of the studies underlying a given relationship.", "operationId": "get_relationship_studies", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "relationship_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Relationship Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: none.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: none."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Study_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/relationships/{relationship_id}/statistical_findings": {"get": {"tags": ["Relationships"], "summary": "Get relationship statistical findings", "description": "Get a list of the statistical findings underlying a given relationship.", "operationId": "get_relationship_statistical_findings", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "relationship_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Relationship Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/graph/{topic_id}": {"get": {"tags": ["Graph"], "summary": "Get subgraph by topic id", "description": "Gets a subgraph of a topic by id.\n        The subgraph includes upstream and downstream relationships within n degrees.", "operationId": "get_subgraph_by_topic_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "topic_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Topic Id"}}, {"name": "n_degree", "in": "query", "required": false, "schema": {"anyOf": [{"type": "integer"}, {"type": "null"}], "description": "The number of degrees to search over to create the graph.", "default": 2, "title": "N Degree"}, "description": "The number of degrees to search over to create the graph."}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Graph"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/graph/cypher": {"post": {"tags": ["Graph"], "summary": "Query graph with cypher", "description": "Query the topic graph with any cypher query.\n        For querying:\n        - The schema is provided by the `/cypher/schema` endpoint.\n        - `ret_type` can be either `records` or `graph` to return the list of Records or a Graph of the result.", "operationId": "post_cypher_statement", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/CypherStatement"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PostCypherResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"APIKeyHeader": []}]}}, "/v0/graph/cypher/schema": {"get": {"tags": ["Graph"], "summary": "Schema for cypher queries", "description": "Schema for node and relationship properties to query in cypher.", "operationId": "get_cypher_schema", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CypherSchema"}}}}}, "security": [{"APIKeyHeader": []}]}}, "/v0/synthesis/pubmed_search_translation": {"post": {"tags": ["Synthesis"], "summary": "Translate query to pubmed search", "description": "Translate query to pubmed search.", "operationId": "translate_query_to_pubmed_search", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/PubmedSearchTranslationInput"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"$ref": "#/components/schemas/SuggestedPubmedSearch"}, "type": "array", "title": "Response Translate Query To Pubmed Search"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"APIKeyHeader": []}]}}, "/v0/synthesis/pubmed_search": {"post": {"tags": ["Synthesis"], "summary": "Initiate pubmed search synthesis", "description": "Initiate pubmed search synthesis.", "operationId": "synthesize_pubmed_search", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/PubmedSearchSynthesisInput"}}}, "required": true}, "responses": {"202": {"description": "Job ID", "content": {"application/json": {"schema": {"type": "string", "title": "Response Synthesize Pubmed Search"}}}}, "204": {"description": "No content"}, "503": {"description": "Service Unavailable"}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"APIKeyHeader": []}]}}, "/v0/synthesis/pubmed_search/{job_id}": {"get": {"tags": ["Synthesis"], "summary": "Get pubmed search synthesis by ID", "description": "Get information about a pubmed search synthesis job.", "operationId": "get_pubmed_search_synthesis_by_id", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PubmedSearchSynthesisJob"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/studies": {"get": {"tags": ["Synthesis"], "summary": "Get studies from pubmed search synthesis", "description": "Get studies from pubmed search synthesis.", "operationId": "get_studies_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, doi, pmid, publish_date, cited_by, study_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: publish_date, sample_size, cited_by."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: none.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: none."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Study_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/statistical_findings": {"get": {"tags": ["Synthesis"], "summary": "Get statistical findings from pubmed search synthesis", "description": "Get statistical findings from pubmed search synthesis.", "operationId": "get_statistical_findings_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, statistic_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatisticalFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/mechanistic_findings": {"get": {"tags": ["Synthesis"], "summary": "Get mechanistic findings from pubmed search synthesis", "description": "Get statistical findings from pubmed search synthesis.", "operationId": "get_mechanistic_findings_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}, {"name": "filter", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, mechanism_type.", "title": "Filter"}, "description": "Fields and values to filter the response by. Supported fields for filtering: id, flagged, topic_1.id, topic_1.wikidata_id, topic_1.umls_cuis, topic_1.category, topic_1.roles, topic_2.id, topic_2.wikidata_id, topic_2.umls_cuis, topic_2.category, topic_2.roles, variable_1.id, variable_1.num_studies, variable_1.topic.id, variable_1.topic.wikidata_id, variable_1.topic.umls_cuis, variable_1.topic.category, variable_1.topic.roles, variable_2.id, variable_2.num_studies, variable_2.topic.id, variable_2.topic.wikidata_id, variable_2.topic.umls_cuis, variable_2.topic.category, variable_2.topic.roles, study.id, study.doi, study.pmid, study.publish_date, study.cited_by, study.study_type, mechanism_type."}, {"name": "sort", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to sort the response by. Supported fields for sorting: none.", "title": "Sort"}, "description": "Field to sort the response by. Supported fields for sorting: none."}, {"name": "search", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name.", "title": "Search"}, "description": "Field to search within. Supported fields for searching: topic_1.name, topic_2.name, variable_1.name, variable_2.name."}, {"name": "fields", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Comma-separated list of fields to include in the response.", "title": "Fields"}, "description": "Comma-separated list of fields to include in the response."}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_MechanisticFinding_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/statements": {"get": {"tags": ["Synthesis"], "summary": "Get statements from pubmed search synthesis", "description": "Get statements from pubmed search synthesis.", "operationId": "get_statements_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_Statement_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/synthesis": {"get": {"tags": ["Synthesis"], "summary": "Get synthesis from pubmed search synthesis", "description": "Get synthesis from pubmed search synthesis.", "operationId": "get_synthesis_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Synthesis"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v0/synthesis/pubmed_search/{job_id}/scored_citations": {"get": {"tags": ["Synthesis"], "summary": "Get cited statements with relevance scores from pubmed search synthesis", "description": "Get statements from pubmed search synthesis.", "operationId": "get_scored_citations_in_synthesis_from_pubmed_search", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Job Id"}}, {"name": "include_total", "in": "query", "required": false, "schema": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Include total number of records in the response.", "default": false, "title": "Include Total"}, "description": "Include total number of records in the response."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 0, "description": "Offset", "default": 0, "title": "Offset"}, "description": "Offset"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "description": "Limit", "default": 10, "title": "Limit"}, "description": "Limit"}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListResponse_StatementScore_"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}}, "components": {"schemas": {"Author": {"properties": {"full_name": {"type": "string", "title": "Full Name", "description": "Full name of author"}, "orcid": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Orcid", "description": "ORCID of author"}, "openalex_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Openalex Id", "description": "OpenAlex ID of author"}}, "type": "object", "required": ["full_name"], "title": "Author", "description": "Author."}, "CypherError": {"properties": {"code": {"type": "string", "title": "Code"}, "message": {"type": "string", "title": "Message"}}, "type": "object", "required": ["code", "message"], "title": "CypherError"}, "CypherNodeSchema": {"properties": {"node_type": {"type": "string", "title": "Node Type"}, "properties": {"items": {"$ref": "#/components/schemas/CypherProperty"}, "type": "array", "title": "Properties"}}, "type": "object", "required": ["node_type", "properties"], "title": "CypherNodeSchema"}, "CypherProperty": {"properties": {"name": {"type": "string", "title": "Name"}, "types": {"items": {"type": "string"}, "type": "array", "title": "Types"}, "mandatory": {"type": "boolean", "title": "Mandatory"}}, "type": "object", "required": ["name", "types", "mandatory"], "title": "CypherProperty"}, "CypherRelationshipSchema": {"properties": {"rel_type": {"type": "string", "title": "Rel Type"}, "properties": {"items": {"$ref": "#/components/schemas/CypherProperty"}, "type": "array", "title": "Properties"}}, "type": "object", "required": ["rel_type", "properties"], "title": "CypherRelationshipSchema"}, "CypherReturnType": {"type": "string", "enum": ["records", "graph"], "title": "CypherReturnType", "description": "Cypher return type."}, "CypherSchema": {"properties": {"nodes": {"items": {"$ref": "#/components/schemas/CypherNodeSchema"}, "type": "array", "title": "Nodes"}, "relationships": {"items": {"$ref": "#/components/schemas/CypherRelationshipSchema"}, "type": "array", "title": "Relationships"}}, "type": "object", "required": ["nodes", "relationships"], "title": "CypherSchema"}, "CypherStatement": {"properties": {"statement": {"type": "string", "title": "Statement"}, "parameters": {"anyOf": [{"type": "object"}, {"type": "null"}], "title": "Parameters"}, "ret_type": {"anyOf": [{"$ref": "#/components/schemas/CypherReturnType"}, {"type": "null"}], "default": "records"}}, "type": "object", "required": ["statement"], "title": "CypherStatement"}, "FindingType": {"type": "string", "enum": ["statistical", "mechanistic"], "title": "FindingType", "description": "Type of finding."}, "Flag": {"properties": {"flagged_property": {"type": "string", "title": "Flagged Property"}, "reason": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Reason"}, "resource_id": {"type": "string", "title": "Resource Id"}, "system_id": {"type": "string", "title": "System Id"}}, "type": "object", "required": ["flagged_property", "resource_id", "system_id"], "title": "Flag", "description": "Flag."}, "FlagInput": {"properties": {"flagged_property": {"type": "string", "title": "Flagged Property"}, "reason": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Reason"}}, "type": "object", "required": ["flagged_property"], "title": "FlagInput", "description": "Flag input."}, "Graph": {"properties": {"directed": {"type": "boolean", "title": "Directed"}, "multigraph": {"type": "boolean", "title": "Multigraph"}, "nodes": {"items": {"$ref": "#/components/schemas/Node"}, "type": "array", "title": "Nodes"}, "links": {"items": {"$ref": "#/components/schemas/Link"}, "type": "array", "title": "Links"}}, "type": "object", "required": ["directed", "multigraph", "nodes", "links"], "title": "Graph"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "JobStatus": {"type": "string", "enum": ["accepted", "clustering", "clustering_failed", "clustering_failed_no_clusters", "synthesizing", "synthesis_not_exists", "synthesis_submitted", "synthesis_running", "synthesis_success", "synthesis_failed", "synthesis_failed_no_citations", "synthesis_failed_validation"], "title": "JobStatus", "description": "Status of a pubmed search synthesis job."}, "Link": {"properties": {"source": {"type": "string", "title": "Source"}, "target": {"type": "string", "title": "Target"}, "last_published": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Published"}, "median_effect_size": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Median Effect Size"}, "num_studies": {"type": "integer", "title": "Num Studies"}, "highest_cited": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Highest Cited"}, "num_significant_findings": {"type": "integer", "title": "Num Significant Findings"}, "num_findings": {"type": "integer", "title": "Num Findings"}}, "type": "object", "required": ["source", "target", "num_studies", "num_significant_findings", "num_findings"], "title": "Link"}, "ListResponse_MechanisticFinding_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/MechanisticFinding"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[MechanisticFinding]"}, "ListResponse_Relationship_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/Relationship"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[Relationship]"}, "ListResponse_StatementScore_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/StatementScore"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[StatementScore]"}, "ListResponse_Statement_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/Statement"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[Statement]"}, "ListResponse_StatisticalFinding_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/StatisticalFinding"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[StatisticalFinding]"}, "ListResponse_Study_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/Study"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[Study]"}, "ListResponse_TopicPath_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/TopicPath"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[TopicPath]"}, "ListResponse_Topic_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/Topic"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[Topic]"}, "ListResponse_Variable_": {"properties": {"data": {"items": {"$ref": "#/components/schemas/Variable"}, "type": "array", "title": "Data"}, "total": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Total"}}, "type": "object", "required": ["data"], "title": "ListResponse[Variable]"}, "MechanismType": {"type": "string", "enum": ["Activation", "Inhibition", "PositiveRegulation", "NegativeRegulation", "Phosphorylation", "Dephosphorylation", "IncreaseAmount", "DecreaseAmount", "Complex", "Conversion", "Gef", "Gap", "Modification", "Affect", "Ubiquitination", "Deubiquitination", "Sumoylation", "Desumoylation", "Hydroxylation", "Dehydroxylation", "Acetylation", "Deacetylation", "Glycosylation", "Deglycosylation", "Farnesylation", "Defarnesylation", "Geranylgeranylation", "Degeranylgeranylation", "Palmitoylation", "Depalmitoylation", "Myristoylation", "Demyristoylation", "Ribosylation", "Deribosylation", "Methylation", "Demethylation"], "title": "MechanismType", "description": "Mechanisms for mechanistic findings."}, "MechanisticFinding": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier", "filterable": true}, "flagged": {"type": "boolean", "title": "Flagged", "description": "Whether finding is flagged", "default": false, "filterable": true}, "finding_type": {"type": "string", "enum": ["mechanistic"], "const": "mechanistic", "title": "Finding Type", "description": "Type of finding", "default": "mechanistic"}, "summary": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Summary", "description": "Summary of the finding"}, "topic_1": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Source topic of the finding", "filterable": true, "searchable": true}, "topic_2": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Target topic of the finding", "filterable": true, "searchable": true}, "variable_1": {"allOf": [{"$ref": "#/components/schemas/Variable"}], "description": "Source variable of the finding", "filterable": true, "searchable": true}, "variable_2": {"allOf": [{"$ref": "#/components/schemas/Variable"}], "description": "Target variable of the finding", "filterable": true, "searchable": true}, "study": {"allOf": [{"$ref": "#/components/schemas/Study"}], "description": "Study supporting the finding", "filterable": true}, "mechanism_type": {"anyOf": [{"$ref": "#/components/schemas/MechanismType"}, {"type": "null"}], "description": "Type of mechanism", "filterable": true}}, "type": "object", "required": ["id"], "title": "MechanisticFinding", "description": "Mechanistic finding."}, "Node": {"properties": {"id": {"type": "string", "title": "Id"}, "label": {"type": "string", "title": "Label"}, "category": {"type": "string", "title": "Category"}, "roles": {"items": {"type": "string"}, "type": "array", "title": "Roles"}}, "type": "object", "required": ["id", "label", "category", "roles"], "title": "Node"}, "PostCypherData": {"oneOf": [{"$ref": "#/components/schemas/PostCypherGraphData"}, {"$ref": "#/components/schemas/PostCypherRecordsData"}], "title": "PostCypherData", "discriminator": {"propertyName": "type", "mapping": {"graph": "#/components/schemas/PostCypherGraphData", "records": "#/components/schemas/PostCypherRecordsData"}}}, "PostCypherGraphData": {"properties": {"type": {"type": "string", "enum": ["graph"], "const": "graph", "title": "Type"}, "content": {"$ref": "#/components/schemas/Graph"}}, "type": "object", "required": ["type", "content"], "title": "PostCypherGraphData"}, "PostCypherRecordsData": {"properties": {"type": {"type": "string", "enum": ["records"], "const": "records", "title": "Type"}, "content": {"items": {"type": "object"}, "type": "array", "title": "Content"}}, "type": "object", "required": ["type", "content"], "title": "PostCypherRecordsData"}, "PostCypherResponse": {"properties": {"data": {"anyOf": [{"$ref": "#/components/schemas/PostCypherData"}, {"type": "null"}]}, "error": {"anyOf": [{"$ref": "#/components/schemas/CypherError"}, {"type": "null"}]}}, "type": "object", "title": "PostCypherResponse"}, "PubmedSearchSynthesisInput": {"properties": {"query": {"type": "string", "title": "Query"}, "pubmed_query": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Pubmed Query"}, "auto_translate": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "title": "Auto Translate", "default": false}, "score_relevance": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "title": "Score Relevance", "default": false}}, "type": "object", "required": ["query"], "title": "PubmedSearchSynthesisInput", "description": "Pubmed search synthesis input."}, "PubmedSearchSynthesisJob": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier of a Pubmed search synthesis job"}, "status": {"allOf": [{"$ref": "#/components/schemas/JobStatus"}], "description": "Status of job"}, "created_at": {"type": "string", "format": "date-time", "title": "Created At", "description": "Date job was created"}, "updated_at": {"type": "string", "format": "date-time", "title": "Updated At", "description": "Date job was last updated"}, "user_query": {"type": "string", "title": "User Query", "description": "Initial user query"}, "pubmed_query": {"type": "string", "title": "Pubmed Query", "description": "Pubmed query used for synthesis"}, "pubmed_query_translation": {"type": "string", "title": "Pubmed Query Translation", "description": "Translation of pubmed query from the pubmed api"}, "num_pubmed_results": {"type": "integer", "title": "Num Pubmed Results", "description": "Number of results from pubmed query"}, "clustering_finished": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Clustering Finished", "description": "Date clustering was finished"}, "synthesis_finished": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Synthesis Finished", "description": "Date synthesis was finished"}}, "type": "object", "required": ["id", "status", "created_at", "updated_at", "user_query", "pubmed_query"], "title": "PubmedSearchSynthesisJob", "description": "Pubmed search synthesis job."}, "PubmedSearchTranslationInput": {"properties": {"query": {"type": "string", "title": "Query"}}, "type": "object", "required": ["query"], "title": "PubmedSearchTranslationInput", "description": "Pubmed search translation input."}, "Relationship": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier of relationship.", "filterable": true}, "num_findings": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Findings", "description": "Number of findings on relationship", "filterable": true, "sortable": true}, "num_studies": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Studies", "description": "Number of studies supporting relationship", "filterable": true, "sortable": true}, "num_significant_findings": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Significant Findings", "description": "Number of significant findings on relationship", "filterable": true, "sortable": true}, "highest_cited": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Highest Cited", "description": "Highest cited study supporting relationship", "filterable": true, "sortable": true}, "median_effect_size": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Median Effect Size", "description": "Median effect size of findings on relationship", "filterable": true, "sortable": true}, "last_updated": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Updated", "description": "Date relationship was last updated", "filterable": true, "sortable": true}, "has_experimental_trial": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "title": "Has Experimental Trial", "description": "Whether or not the relationship is supported by an experimental trial", "filterable": true, "sortable": true}, "source_topic": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Unique identifier of the source topic", "filterable": true, "searchable": true}, "target_topic": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Unique identifier of the target topic", "filterable": true, "searchable": true}}, "type": "object", "required": ["id"], "title": "Relationship", "description": "Relationship."}, "Sign": {"properties": {"rationale": {"type": "string", "title": "Rationale"}, "sign": {"type": "string", "title": "Sign"}}, "type": "object", "required": ["rationale", "sign"], "title": "Sign"}, "Statement": {"properties": {"summary": {"type": "string", "title": "Summary"}, "finding_ids": {"items": {"type": "string"}, "type": "array", "title": "Finding Ids"}, "finding_type": {"$ref": "#/components/schemas/FindingType"}}, "type": "object", "required": ["summary", "finding_ids", "finding_type"], "title": "Statement", "description": "Statements generated from aggregated findings."}, "StatementScore": {"properties": {"statement": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Statement", "description": "Evidence statement."}, "score": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Score", "description": "Statement relevancy score."}, "reasoning": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Reasoning", "description": "Statement score reasoning."}}, "type": "object", "title": "StatementScore", "description": "Statement relevancy score with reasoning."}, "StatisticType": {"type": "string", "enum": ["odds_ratio", "adjusted_odds_ratio", "hazard_ratio", "adjusted_hazard_ratio", "relative_risk_ratio", "coefficient", "pearson_r", "incident_rate_ratio", "prevalence_ratio", "spearman_correlation", "mean_difference_standardized", "mean_difference_unstandardized", "risk_difference", "coefficient_of_determination", "t_test", "elasticity", "gini_coefficient"], "title": "StatisticType", "description": "Statistic type."}, "StatisticalFinding": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier", "filterable": true}, "flagged": {"type": "boolean", "title": "Flagged", "description": "Whether finding is flagged", "default": false, "filterable": true}, "finding_type": {"type": "string", "enum": ["statistical"], "const": "statistical", "title": "Finding Type", "description": "Type of finding", "default": "statistical"}, "summary": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Summary", "description": "Summary of the finding"}, "topic_1": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Source topic of the finding", "filterable": true, "searchable": true}, "topic_2": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Target topic of the finding", "filterable": true, "searchable": true}, "variable_1": {"allOf": [{"$ref": "#/components/schemas/Variable"}], "description": "Source variable of the finding", "filterable": true, "searchable": true}, "variable_2": {"allOf": [{"$ref": "#/components/schemas/Variable"}], "description": "Target variable of the finding", "filterable": true, "searchable": true}, "study": {"allOf": [{"$ref": "#/components/schemas/Study"}], "description": "Study supporting the finding", "filterable": true}, "statistic_type": {"anyOf": [{"$ref": "#/components/schemas/StatisticType"}, {"type": "null"}], "description": "Type of statistic", "filterable": true}, "statistic_value": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Statistic Value", "description": "Value of statistic"}, "effect_size": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Effect Size", "description": "Effect size"}, "ci_upper": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Ci Upper", "description": "Upper bound of confidence interval"}, "ci_lower": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Ci Lower", "description": "Lower bound of confidence interval"}, "p_value": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "P Value", "description": "P-value"}}, "type": "object", "required": ["id"], "title": "StatisticalFinding", "description": "Statistical finding."}, "Study": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier", "filterable": true}, "doi": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Doi", "description": "Digital Object Identifier (DOI)", "filterable": true}, "pmid": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Pmid", "description": "PubMed Identifier (PMID)", "filterable": true}, "title": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Title", "description": "Title of the study"}, "authors": {"anyOf": [{"items": {"$ref": "#/components/schemas/Author"}, "type": "array"}, {"type": "null"}], "title": "Authors", "description": "Authors of the study"}, "journal": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Journal", "description": "Journal the study was published in"}, "publish_date": {"anyOf": [{"type": "string", "format": "date"}, {"type": "null"}], "title": "Publish Date", "description": "Year of publication", "filterable": true, "sortable": true}, "population": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Population", "description": "Population studied"}, "sample_size": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Sample Size", "description": "Sample size of the study", "sortable": true}, "summary": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Summary", "description": "Summary of the study"}, "cited_by": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Cited By", "description": "Number of times study was cited by another study", "filterable": true, "sortable": true}, "study_type": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Study Type", "description": "Type of study", "filterable": true}, "retraction_reason": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Retraction Reason", "description": "Reason for retraction of study"}}, "type": "object", "required": ["id"], "title": "Study", "description": "Study."}, "SuggestedPubmedSearch": {"properties": {"query": {"type": "string", "title": "Query"}, "num_studies": {"type": "integer", "title": "Num Studies"}}, "type": "object", "required": ["query", "num_studies"], "title": "SuggestedPubmedSearch", "description": "Suggested query."}, "Synthesis": {"properties": {"summaries": {"items": {"$ref": "#/components/schemas/SynthesisSummary"}, "type": "array", "title": "Summaries", "description": "Thematic summaries of the findings."}, "scores": {"anyOf": [{"items": {"$ref": "#/components/schemas/SynthesisScores"}, "type": "array"}, {"type": "null"}], "title": "Scores", "description": "Scores (with reasoning) for each synthesis summary."}}, "type": "object", "required": ["summaries"], "title": "Synthesis", "description": "Synthesis response."}, "SynthesisScores": {"properties": {"score": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Score", "description": "Summary relevance score."}, "reasoning": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Reasoning", "description": "Reasoning for summary relevance score."}}, "type": "object", "title": "SynthesisScores", "description": "Synthesis summary scores."}, "SynthesisSummary": {"properties": {"theme": {"type": "string", "title": "Theme", "description": "Theme of the summary"}, "summary": {"type": "string", "title": "Summary", "description": "Summary of the theme"}}, "type": "object", "required": ["theme", "summary"], "title": "SynthesisSummary", "description": "Synthesis summary."}, "Topic": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier", "filterable": true}, "name": {"type": "string", "title": "Name", "description": "Name of the topic", "searchable": true}, "wikidata_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Wikidata Id", "description": "Wikidata identifier for the topic", "filterable": true}, "umls_cuis": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Umls Cuis", "description": "UMLS Concept Unique Identifiers (CUIs) for the topic", "filterable": true}, "category": {"anyOf": [{"$ref": "#/components/schemas/TopicCategory"}, {"type": "null"}], "description": "Category of the topic", "filterable": true}, "roles": {"anyOf": [{"items": {"$ref": "#/components/schemas/TopicRole"}, "type": "array"}, {"type": "null"}], "title": "Roles", "description": "Roles associated with the topic", "filterable": true}}, "type": "object", "required": ["id", "name"], "title": "Topic", "description": "Topic."}, "TopicCategory": {"type": "string", "enum": ["Biomedical - Diseases & disorders", "Biomedical - Hospitalization", "Biomedical - Mortality/survival", "Biomedical - Pathogen", "Biomedical - Ethnicity", "Biomedical - Other biological factors", "Biomedical - Anthropometry", "Biomedical - Age", "Biomedical - Sex", "Biomedical - Carcinogen", "Biomedical - Genetics", "Behavioral - Personal hygiene", "Behavioral - Other dietary factors", "Behavioral - Stress", "Behavioral - Substance use", "Behavioral - Eating behaviors", "Behavioral - Sleep", "Behavioral - Physical activity", "Behavioral - Other behavioral factors", "Behavioral - Sexual behavior", "Environmental - Air quality", "Environmental - Water quality", "Environmental - Weather and climate change", "Environmental - Other environmental factors", "Social - Education", "Social - Economic context", "Social - Other social factors", "Social - Physical infrastructure", "Social - Social context", "Social - Healthcare context", "Social - Occupation", "Social - Geography", "Social - Occupational context", "Healing", "Preventative", "Diagnostic", "Preservative", "Managing", "Therapeutic", "Other"], "title": "TopicCategory", "description": "Topic category."}, "TopicPath": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier of relationship.", "filterable": true}, "num_findings": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Findings", "description": "Number of findings on relationship", "filterable": true, "sortable": true}, "num_studies": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Studies", "description": "Number of studies supporting relationship", "filterable": true, "sortable": true}, "num_significant_findings": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Significant Findings", "description": "Number of significant findings on relationship", "filterable": true, "sortable": true}, "highest_cited": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Highest Cited", "description": "Highest cited study supporting relationship", "filterable": true, "sortable": true}, "median_effect_size": {"anyOf": [{"type": "number"}, {"type": "null"}], "title": "Median Effect Size", "description": "Median effect size of findings on relationship", "filterable": true, "sortable": true}, "last_updated": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Updated", "description": "Date relationship was last updated", "filterable": true, "sortable": true}, "has_experimental_trial": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "title": "Has Experimental Trial", "description": "Whether or not the relationship is supported by an experimental trial", "filterable": true, "sortable": true}, "topic": {"allOf": [{"$ref": "#/components/schemas/Topic"}], "description": "Topic in path", "filterable": true, "searchable": true}}, "type": "object", "required": ["id", "topic"], "title": "TopicPath", "description": "Path to topic."}, "TopicRole": {"type": "string", "enum": ["Determinant", "Intervention", "Outcome", "Agent"], "title": "TopicRole", "description": "Topic role."}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}, "Variable": {"properties": {"id": {"type": "string", "title": "Id", "description": "Unique identifier", "filterable": true}, "name": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Name", "description": "Name of the variable", "searchable": true}, "num_studies": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Num Studies", "description": "Number of studies the variable appears in", "filterable": true, "sortable": true}, "topic": {"anyOf": [{"$ref": "#/components/schemas/Topic"}, {"type": "null"}], "description": "Topic that the variable is matched to", "filterable": true}}, "type": "object", "required": ["id"], "title": "Variable", "description": "Variable."}}, "securitySchemes": {"APIKeyHeader": {"type": "apiKey", "in": "header", "name": "x-api-key"}}}}