{"endpoints":[{"identifier":"ws-gff3-query","minVersion":10,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for sequence\nannotations, and returning results in [GFF3](http://en.wikipedia.org/wiki/General_feature_format)\nformat. The user is responsible for\nensuring that the query contains only suitable types for export.\nA suitable query is one where every view column references a\nfield of a `SequenceFeature` (including all sub-classes). The\nparticular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/gff3","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id Gene.exons.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"},{"Type":"String[]","Description":"Extra columns to include as extra information in the ninth column","Required":"N","Recommended":false,"Default":"Gene.length","Name":"view"}],"Synopsis":"Query the Database for Sequence Annotations."},{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for sequence\nannotations, and returning results in [GFF3](http://en.wikipedia.org/wiki/General_feature_format)\nformat. The user is responsible for\nensuring that the query contains only suitable types for export.\nA suitable query is one where every view column references a\nfield of a `SequenceFeature` (including all sub-classes). The\nparticular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/gff3","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id Gene.exons.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"},{"Type":"String[]","Description":"Extra columns to include as extra information in the ninth column","Required":"N","Recommended":false,"Default":"Gene.length","Name":"view"}],"Synopsis":"Query the Database for Sequence Annotations."}],"name":"GFF3 Query Results","URI":"/service/query/results/gff3"},{"identifier":"ws-gff3-lists","minVersion":10,"methods":[{"DescriptionFormat":"markdown","Description":"This service allows users to export the contents of a list\nof `SequenceFeature`s as GFF3.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/results/gff3","parameters":[{"Options":"/lists|lists{status=CURRENT,type=Gene}","Type":"String","Description":"The name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"}],"Synopsis":"Get the Contents of a List as GFF3."},{"DescriptionFormat":"markdown","Description":"This service allows users to export the contents of a list\nof `SequenceFeature`s as GFF3.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/results/gff3","parameters":[{"Options":"/lists|lists{status=CURRENT,type=Gene}","Type":"String","Description":"The name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"}],"Synopsis":"Get the Contents of a List as GFF3."}],"name":"List as GFF3","URI":"/service/list/results/gff3"},{"identifier":"ws-fa-lists","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This service allows users to export the contents of a list\nof `SequenceFeature`s or `Protein`s as\n[FASTA](http://en.wikipedia.org/wiki/FASTA_format)\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/results/fasta","parameters":[{"Options":"/lists|lists{status=CURRENT,type=Gene,type=Protein}","Type":"String","Description":"The name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"}],"Synopsis":"Get the Contents of a List as FASTA."},{"DescriptionFormat":"markdown","Description":"This service allows users to export the contents of a list\nof `SequenceFeature`s or `Protein`s as\n[FASTA](http://en.wikipedia.org/wiki/FASTA_format)\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/results/fasta","parameters":[{"Options":"/lists|lists{status=CURRENT,type=Gene,type=Protein}","Type":"String","Description":"The name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"}],"Synopsis":"Get the Contents of a List as FASTA."}],"name":"List as FASTA","URI":"/service/list/results/fasta"},{"identifier":"ws-fasta-query","minVersion":10,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for sequence,\nand returning results in [FASTA](http://en.wikipedia.org/wiki/FASTA_format)\nformat. The user is responsible for\nensuring that the query contains only suitable types for export.\n\nA suitable query is one with a single view column which references a\nfield of a `SequenceFeature` (including all sub-classes) or of a\na `Protein`. The particular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/fasta","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"},{"Type":"String[]","Description":"Extra columns to include as extra information in the ninth column","Required":"N","Recommended":false,"Default":"Gene.length","Name":"view"}],"Synopsis":"Query the Database for Sequence."},{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for sequence,\nand returning results in [FASTA](http://en.wikipedia.org/wiki/FASTA_format)\nformat. The user is responsible for\nensuring that the query contains only suitable types for export.\n\nA suitable query is one with a single view column which references a\nfield of a `SequenceFeature` (including all sub-classes) or of a\na `Protein`. The particular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/fasta","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"},{"Type":"String[]","Description":"Extra columns to include as extra information in the ninth column","Required":"N","Recommended":false,"Default":"Gene.length","Name":"view"}],"Synopsis":"Query the Database for Sequence."}],"name":"FASTA Query Results","URI":"/service/query/results/fasta"},{"identifier":"ws-bed-query","minVersion":10,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for genomic locations,\nand returning results in [UCSC BED](http://genome.ucsc.edu/FAQ/FAQformat.html) format.\nThe user is responsible for ensuring that the query contains only suitable types for export.\n\nA suitable query is one where every view column references a\nfield of a `SequenceFeature` (including all sub-classes).\nThe particular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/bed","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id Gene.exons.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"}],"Synopsis":"Query the Database for Locations."},{"DescriptionFormat":"markdown","Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML or JSON format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML and JSON\nsyntax.\n\nThis endpoint specialises in dealing with queries for genomic locations,\nand returning results in [UCSC BED](http://genome.ucsc.edu/FAQ/FAQformat.html) format.\nThe user is responsible for ensuring that the query contains only suitable types for export.\n\nA suitable query is one where every view column references a\nfield of a `SequenceFeature` (including all sub-classes).\nThe particular field selected is not important, and the object itself\nwill be selected.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results/bed","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"<query name=\"short genes on the X chromosome\" model=\"genomic\" view=\"Gene.id Gene.exons.id\">\n    <constraint path=\"Gene.chromosome.primaryIdentifier\" op=\"=\" value=\"X\"/>\n    <constraint path=\"Gene.length\" op=\"&lt;\" value=\"1000\"/>\n<\/query>","Name":"query"}],"Synopsis":"Query the Database for Locations."}],"name":"BED Query Results","URI":"/service/query/results/bed"},{"identifier":"ws-genomic-region-to-list","minVersion":8,"methods":[{"DescriptionFormat":"markdown","Description":"This service creates a list of features found\noverlapping a set of genomic intervals. All features\nfound will be saved in a list of the given name. The type of this\nlist will be inferred from the types provided in the search input.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/regions/list","parameters":[{"Type":"String","Description":"The name of the list to save these features to","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"An optional description for this list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to this list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"JSON","Description":"The region search input","Required":"Y","Recommended":false,"Default":" {\n     \"regions\": [\n     \"2L:14615455..14619002\",\n     \"2R:5866646..5868384\",\n     \"3R:2578486..2580016\"\n     ],\n     \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n     \"organism\": \"D. melanogaster\"\n }\n               ","Name":"query"}],"Synopsis":"Create a New List from Features found in Genomic Intervals"},{"DescriptionFormat":"markdown","Description":"This service creates a list of features found\noverlapping a set of genomic intervals. All features\nfound will be saved in a list of the given name. The type of this\nlist will be inferred from the types provided in the search input.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"A representation of the search request.","body":[{"schema":"/schema/region-search-request.schema","contentType":"application/json","example":"{\n  \"regions\": [\n    \"2L:14615455..14619002\",\n    \"2R:5866646..5868384\",\n    \"3R:2578486..2580016\"\n  ],\n  \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n  \"organism\": \"D. melanogaster\"\n}\n              "}],"URI":"/regions/list","parameters":[{"Type":"String","Description":"The name of the list to save these features to","Required":"Y","Recommended":false,"Name":"listName"},{"Type":"String","Description":"An optional description for this list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to this list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"}],"Synopsis":"Create a New List from Features found in Genomic Intervals"}],"name":"Create List from Genomic Intervals","URI":"/service/regions/list"},{"identifier":"ws-genomic-region-to-gff3","minVersion":8,"methods":[{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the General Feature Format\n[GFF3](http://en.wikipedia.org/wiki/General_feature_format)\nwhere each row represents a feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/regions/gff3","parameters":[{"Type":"JSON","Description":"The region search input","Required":"Y","Recommended":false,"Default":" {\n     \"regions\": [\n     \"2L:14615455..14619002\",\n     \"2R:5866646..5868384\",\n     \"3R:2578486..2580016\"\n     ],\n     \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n     \"organism\": \"D. melanogaster\"\n }\n               ","Name":"query"}],"Synopsis":"Get Genomic Features overlapping given Regions"},{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the General Feature Format\n[GFF3](http://en.wikipedia.org/wiki/General_feature_format)\nwhere each row represents a feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","bodyDescription":"A representation of the search request.","body":[{"schema":"/schema/region-search-request.schema","contentType":"application/json","example":"{\n  \"regions\": [\n    \"2L:14615455..14619002\",\n    \"2R:5866646..5868384\",\n    \"3R:2578486..2580016\"\n  ],\n  \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n  \"organism\": \"D. melanogaster\"\n}\n              "}],"URI":"/regions/gff3","parameters":[],"Synopsis":"Get Genomic Features overlapping given Regions"}],"name":"Genomic Intervals as GFF3","URI":"/service/regions/gff3"},{"identifier":"ws-genomic-region-to-fasta","minVersion":8,"methods":[{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the\n[FASTA](http://en.wikipedia.org/wiki/FASTA_format) format\nwhere each record represents a feature, including the sequence\nassociated with that feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/regions/sequence","parameters":[{"Type":"JSON","Description":"The region search input","Required":"Y","Recommended":false,"Default":" {\n     \"regions\": [\n     \"2L:14615455..14619002\",\n     \"2R:5866646..5868384\",\n     \"3R:2578486..2580016\"\n     ],\n     \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n     \"organism\": \"D. melanogaster\"\n }\n               ","Name":"query"}],"Synopsis":"Get Genomic Features overlapping given Regions"},{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the\n[FASTA](http://en.wikipedia.org/wiki/FASTA_format) format\nwhere each record represents a feature, including the sequence\nassociated with that feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","bodyDescription":"A representation of the search request.","body":[{"schema":"/schema/region-search-request.schema","contentType":"application/json","example":"{\n  \"regions\": [\n    \"2L:14615455..14619002\",\n    \"2R:5866646..5868384\",\n    \"3R:2578486..2580016\"\n  ],\n  \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n  \"organism\": \"D. melanogaster\"\n}\n              "}],"URI":"/regions/sequence","parameters":[],"Synopsis":"Get Genomic Features overlapping given Regions"}],"name":"Genomic Intervals as FASTA","URI":"/service/regions/sequence"},{"identifier":"ws-genomic-region-to-bed","minVersion":8,"methods":[{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the [UCSC BED](http://genome.ucsc.edu/FAQ/FAQformat.html) format\nwhere each row represents a feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/regions/bed","parameters":[{"Type":"JSON","Description":"The region search input","Required":"Y","Recommended":false,"Default":" {\n     \"regions\": [\n     \"2L:14615455..14619002\",\n     \"2R:5866646..5868384\",\n     \"3R:2578486..2580016\"\n     ],\n     \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n     \"organism\": \"D. melanogaster\"\n }\n               ","Name":"query"}],"Synopsis":"Get Genomic Features overlapping given Regions"},{"DescriptionFormat":"markdown","Description":"This service returns information about features found\noverlapping a set of genomic intervals. The results are\nreturned in the [UCSC BED](http://genome.ucsc.edu/FAQ/FAQformat.html) format\nwhere each row represents a feature.\n\nThe input to this service is a `json` object that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"regions\", \"featureTypes\", \"organism\"],\n    \"properties\": {\n        \"regions\": \"#/definitions/stringset\",\n        \"featureTypes\": \"#/definitions/stringset\",\n        \"isInterbase\": { \"type\": \"boolean\" },\n        \"extension\": { \"type\": \"number\" },\n        \"organism\": { \"type\": \"string\" }\n    },\n    \"definitions\": {\n        \"stringset\": {\n            \"type\": \"array\",\n            \"items: { \"type: \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        }\n    }\n}\n```\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","bodyDescription":"A representation of the search request.","body":[{"schema":"/schema/region-search-request.schema","contentType":"application/json","example":"{\n  \"regions\": [\n    \"2L:14615455..14619002\",\n    \"2R:5866646..5868384\",\n    \"3R:2578486..2580016\"\n  ],\n  \"featureTypes\": [\"Gene\", \"Exon\", \"Intron\"],\n  \"organism\": \"D. melanogaster\"\n}\n              "}],"URI":"/regions/bed","parameters":[],"Synopsis":"Get Genomic Features overlapping given Regions"}],"name":"Genomic Intervals as BED","URI":"/service/regions/bed"},{"identifier":"ws-external-links","minVersion":31,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides a list of external links given the id of the intermine object.\nUsed for the report page.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/elinks","parameters":[{"Type":"String","Description":"InterMine objectId","Required":"Y","Recommended":false,"Default":"100011001","Name":"id"}],"Synopsis":"External links for intermine object."},{"DescriptionFormat":"markdown","Description":"This service provides a list of external links given the id of the intermine object.\nUsed for the report page.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/elinks","parameters":[{"Type":"String","Description":"InterMine objectId","Required":"Y","Recommended":false,"Default":"100011001","Name":"id"}],"Synopsis":"External links for intermine object."}],"name":"External links","URI":"/service/elinks"},{"identifier":"ws-query-results","minVersion":1,"methods":[{"Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML\nsyntax.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results","parameters":[{"Type":"XML","Description":"A definition of the query to execute in Path-Query XML format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"{ \"from\": \"Gene\", \"select\": [ \"secondaryIdentifier\", \"symbol\", \"primaryIdentifier\", \"organism.name\" ], \"orderBy\": [ { \"path\": \"secondaryIdentifier\", \"direction\": \"ASC\" } ], \"where\": [ { \"path\": \"organism.name\", \"op\": \"=\", \"value\": \"Drosophila melanogaster\", \"code\": \"A\" } ] }\"","Name":"query"},{"Type":"Integer","Description":"The version of the XML format used","Required":"N","Recommended":false,"Default":"2","Name":"version"},{"Type":"Integer","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Type":"Integer","Description":"The maximum size of the result set.","Required":"N","Recommended":true,"Default":"10","Name":"size"},{"Type":"enumerated","Description":"Include column headers. Use friendly for human readable paths. (Only for flat-file formats)","Required":"N","Recommended":false,"EnumeratedList":["none","path","friendly"],"Default":"none","Name":"columnheaders"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["tab","csv","count","json","jsonobjects","jsoncount","xml","html","rdf+xml"],"Default":"tab","Name":"format"}],"Synopsis":"Get results for a query against the database.","returnFormats":[{"accept":"application/tsv","Name":"tab"},{"accept":"application/csv","Name":"csv"},{"accept":"text/count","Name":"count"},{"key":"results","accept":"application/json","Name":"json"},{"key":"results","accept":"application/json;type=objects","Name":"jsonobjects"},{"key":"results","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"application/xml","Name":"xml"},{"accept":"text/html","Name":"html"},{"accept":"application/rdf+xml","Name":"rdf+xml"}]},{"Description":"This service provides full access to arbitrary database queries.\nQueries are accepted in a serialised XML format, executed and returned\nin a streaming manner. The query format is a custom subset of the capabilities\nof SQL; see the InterMine documentation for a full description of the query XML\nsyntax.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"GET","URI":"/query/results","parameters":[{"Type":"XML","Description":"A definition of the query to execute in Path-Query XML format","Required":"Y","Recommended":false,"Schema":"/schema/query.xsd","Default":"{ \"from\": \"Gene\", \"select\": [ \"secondaryIdentifier\", \"symbol\", \"primaryIdentifier\", \"organism.name\" ], \"orderBy\": [ { \"path\": \"secondaryIdentifier\", \"direction\": \"ASC\" } ], \"where\": [ { \"path\": \"organism.name\", \"op\": \"=\", \"value\": \"Drosophila melanogaster\", \"code\": \"A\" } ] }\"","Name":"query"},{"Type":"Integer","Description":"The version of the XML format used","Required":"N","Recommended":false,"Default":"2","Name":"version"},{"Type":"Integer","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Type":"Integer","Description":"The maximum size of the result set.","Required":"N","Recommended":true,"Default":"10","Name":"size"},{"Type":"enumerated","Description":"Include column headers. Use friendly for human readable paths. (Only for flat-file formats)","Required":"N","Recommended":false,"EnumeratedList":["none","path","friendly"],"Default":"none","Name":"columnheaders"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["tab","csv","count","json","jsonobjects","jsoncount","xml","html","rdf+xml"],"Default":"tab","Name":"format"}],"Synopsis":"Get results for a query against the database.","returnFormats":[{"accept":"application/tsv","Name":"tab"},{"accept":"application/csv","Name":"csv"},{"accept":"text/count","Name":"count"},{"key":"results","accept":"application/json","Name":"json"},{"key":"results","accept":"application/json;type=objects","Name":"jsonobjects"},{"key":"results","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"application/xml","Name":"xml"},{"accept":"text/html","Name":"html"},{"accept":"application/rdf+xml","Name":"rdf+xml"}]}],"name":"Query Results","URI":"/service/query/results"},{"identifier":"ws-query-to-list","minVersion":4,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides the facility to submit a query and create a new list\nwhose contents shall be the result set defined by running the query.\n\nThis facility places a couple of restrictions on the query itself, namely that\nthe view list may only contain a single item, which can refer to any attribute\nof an object. The attribute itself will be ignored, and the object itself\nwill be selected. For this reason, one might choose to always select the `.id`\nattribute when using this service.\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/tolist","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Name":"query"},{"Type":"String","Description":"The name for the new list. There must be no existing list of this name","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"A description to attach to the new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Save the result set of a query as a list on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"DescriptionFormat":"markdown","Description":"This service provides the facility to submit a query and create a new list\nwhose contents shall be the result set defined by running the query.\n\nThis facility places a couple of restrictions on the query itself, namely that\nthe view list may only contain a single item, which can refer to any attribute\nof an object. The attribute itself will be ignored, and the object itself\nwill be selected. For this reason, one might choose to always select the `.id`\nattribute when using this service.\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/tolist","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format","Required":"Y","Recommended":false,"Name":"query"},{"Type":"String","Description":"The name for the new list. There must be no existing list of this name","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"A description to attach to the new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Save the result set of a query as a list on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Create List from Query","URI":"/service/query/tolist"},{"identifier":"ws-query-append","minVersion":4,"methods":[{"Description":"This service provides the facility to submit a query and add the objects\ncontained in its result set to a list that already exists on the server. This\nfacility places a couple of restrictions on the query itself, namely that\nthe view list may only contain a single item, which should refer to the\ninternal id attribute of an object in the query.\n              ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/append/tolist","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"String","Description":"The list to append items to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Add the result set of a query to a list on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service provides the facility to submit a query and add the objects\ncontained in its result set to a list that already exists on the server. This\nfacility places a couple of restrictions on the query itself, namely that\nthe view list may only contain a single item, which should refer to the\ninternal id attribute of an object in the query.\n              ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/append/tolist","parameters":[{"Type":"String","Description":"A definition of the query to execute in Path-Query XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"String","Description":"The list to append items to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Add the result set of a query to a list on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Add to List from Query","URI":"/service/query/append/tolist"},{"identifier":"ws-query-upload","minVersion":4,"methods":[{"Description":"This service provides the facility to submit one or more queries\nand save it/them for future reference to a user account on the server.\n                ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/upload","parameters":[{"Type":"String","Description":"A definition of the query/ies to save in Path-Query XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"Integer","Description":"The version of the path-qeury format being used.","Required":"N","Recommended":false,"Name":"version"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Save queries to a user account on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service provides the facility to submit one or more queries\nand save it/them for future reference to a user account on the server.\n                ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/query/upload","parameters":[{"Type":"String","Description":"A definition of the query/ies to save in Path-Query XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"Integer","Description":"The version of the path-qeury format being used.","Required":"N","Recommended":false,"Name":"version"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Save queries to a user account on the server.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Save Query","URI":"/service/query/upload"},{"identifier":"ws-lists","minVersion":1,"methods":[{"Description":"This service allows users to get back a list of\nlists that contain a given object, either defined by an\ninternal ID, or looked up from stable identifiers.\nIf the request does not authenticate to a user account,\nthen only relevant public lists will be returned.\n                ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"GET","URI":"/listswithobject","parameters":[{"Type":"String","Description":"A stable identifier that can be used to find the object.","Required":"N","Recommended":false,"Name":"publicId"},{"Type":"Integer","Description":"The internal DB id (changes on each re-release).","Required":"N","Recommended":false,"Name":"id"},{"Options":"/model|model.classes","Type":"String","Description":"The type of object (required if using a public id)","Required":"N","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"String","Description":"An extra value to disambiguate objects","Required":"N","Recommended":false,"Name":"extraValue"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","html","text","csv","tab"],"Default":"json","Name":"format"}],"Synopsis":"Find lists on the server containing an object.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/html","Name":"html"},{"accept":"text/plain","Name":"text"},{"accept":"application/csv","Name":"csv"},{"accept":"application/tsv","Name":"tab"}]},{"Description":"This service allows users to get back a list of\nlists that contain a given object, either defined by an\ninternal ID, or looked up from stable identifiers.\nIf the request does not authenticate to a user account,\nthen only relevant public lists will be returned.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"GET","URI":"/listswithobject","parameters":[{"Type":"String","Description":"A stable identifier that can be used to find the object.","Required":"N","Recommended":false,"Name":"publicId"},{"Type":"Integer","Description":"The internal DB id (changes on each re-release).","Required":"N","Recommended":false,"Name":"id"},{"Options":"/model|model.classes","Type":"String","Description":"The type of object (required if using a public id)","Required":"N","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"String","Description":"An extra value to disambiguate objects","Required":"N","Recommended":false,"Name":"extraValue"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","html","text","csv","tab"],"Default":"json","Name":"format"}],"Synopsis":"Find lists on the server containing an object.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/html","Name":"html"},{"accept":"text/plain","Name":"text"},{"accept":"application/csv","Name":"csv"},{"accept":"application/tsv","Name":"tab"}]}],"name":"Find Lists Containing an Object","URI":"/service/listswithobject"},{"identifier":"ws-list-append","minVersion":4,"methods":[{"Description":"This service allows users to add new items to an existing\nlist by uploading a set of identifiers. This is equivalent to\ncreating a new list from a set of identifiers, and then performing\nthe union operation on that list an existing one, if the resulant\nlist replaced the existing list.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"Identifiers for objects to add to the list, tab, comma or newline separated.","body":[{"contentType":"text/plain","example":"\"even skipped\"\nzen, bib\nhairless\n          "}],"URI":"/lists/append","parameters":[{"Options":"/lists|lists{authorized,status=CURRENT}","Type":"String","Description":"The name of the list to append to. The list must exist, and belong to you.","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Add items to an existing list by identifiers","returnFormats":[{"key":"list","accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Append to List","URI":"/service/lists/append"},{"identifier":"ws-list-union","minVersion":4,"methods":[{"Description":"This service allows users to create new lists which contain all the members\ncontained in the set of input lists. The user must have access to all the input\nlists, but need not be the owner of any of them. A union of a single list with\nitself may be considered a copy.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","MethodName":"Combine Lists","URI":"/lists/union","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list.","Required":"Y","Recommended":false,"Default":"{name}","Name":"lists"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Combine Two or More Lists through Union","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service allows users to create new lists which contain all the members\ncontained in the set of input lists. The user must have access to all the input\nlists, but need not be the owner of any of them. A union of a single list with\nitself may be considered a copy.\n        ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","MethodName":"Combine Lists","URI":"/lists/union","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list.","Required":"Y","Recommended":false,"Default":"{name}","Name":"lists"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Combine Two or More Lists through Union","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"List Union","URI":"/service/lists/union"},{"identifier":"ws-list-subtract","minVersion":4,"methods":[{"Description":"This service allows users to create new lists which contain only those elements\nwhich are present in one set of lists, and none of those elements which are present\nin another set of lists. This is what is typically thought of as subtraction, or more\ntechnically, the asymmetric difference of two sets. The user must supply the names of\nthe lists to be used as either the source lists or the subtraction lists, as well as\ndetails for the new list to be created. The user must have access to all the named lists,\nbut need not be the owner of any of them.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/lists/subtract","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list","Required":"Y","Recommended":false,"Default":"{name}","Name":"references"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a list to exclude","Required":"Y","Recommended":false,"Default":"{name}","Name":"subtract"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Subtract one List From Another","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service allows users to create new lists which contain only those elements\nwhich are present in one set of lists, and none of those elements which are present\nin another set of lists. This is what is typically thought of as subtraction, or more\ntechnically, the asymmetric difference of two sets. The user must supply the names of\nthe lists to be used as either the source lists or the subtraction lists, as well as\ndetails for the new list to be created. The user must have access to all the named lists,\nbut need not be the owner of any of them.\n        ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/lists/subtract","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list","Required":"Y","Recommended":false,"Default":"{name}","Name":"references"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a list to exclude","Required":"Y","Recommended":false,"Default":"{name}","Name":"subtract"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Subtract one List From Another","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"List Subtraction","URI":"/service/lists/subtract"},{"identifier":"ws-list-intersect","minVersion":4,"methods":[{"Description":"This service allows users to create new lists which contain only those items\nwhich are members of all the source lists. The user must have access to all the input\nlists, but need not be the owner of any of them. An intersection of a single list\nmay be considered a copy.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Intersect Lists","URI":"/lists/intersect","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list, or multiple list names concatenated with a ';' separator.","Required":"Y","Recommended":false,"Default":"{name}","Name":"lists"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Combine Two or More Lists through Intersection","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"List Intersection","URI":"/service/lists/intersect"},{"identifier":"ws-list-diff","minVersion":4,"methods":[{"Description":"This service allows users to create new lists which only contain members which are not shared\nby an even number of lists (see: http://en.wikipedia.org/wiki/Symmetric_difference).\nThe user must have access to all the input lists, but need not be the owner of any of them.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Symmetric Difference","URI":"/lists/diff","parameters":[{"Type":"String","Description":"The name of the list to create","Required":"Y","Recommended":false,"Name":"name"},{"Options":"/lists|lists{status=CURRENT}","Type":"String[]","Description":"The name of a source list","Required":"Y","Recommended":false,"Default":"{name}","Name":"lists"},{"Type":"String","Description":"A description of this new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to apply to the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Combine Two or More Lists through Difference","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"List Difference","URI":"/service/lists/diff"},{"identifier":"ws-available-lists","minVersion":4,"methods":[{"Description":"This service allows users to get back a list of\nlists that they have access to. The lists can be optionally\nbe filtered on the server by name, thus returning just a single\nname, or if '*' wildcards are used, a subset of all lists.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/lists","parameters":[{"Type":"String","Description":"An optional filter by name.","Required":"N","Recommended":false,"Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","html","text","csv","tab"],"Default":"json","Name":"format"}],"Synopsis":"Find lists on the server.","returnFormats":[{"key":"lists","accept":"application/json","Name":"json"},{"accept":"text/html","Name":"html"},{"accept":"text/plain","Name":"text"},{"accept":"application/csv","Name":"csv"},{"accept":"application/tsv","Name":"tab"}]},{"Description":"This service allows users to delete\nlists that belong to them.\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/lists","parameters":[{"Options":"/lists|lists{authorized}","Type":"String","Description":"The name of the list to delete","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Delete an existing list","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service allows users to create a new\nlist by uploading a set of identifiers.\n  The list is created by using the default settings\n  of the ID resolution mechanism and then taking\n  all the good matches.\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"Identifiers for objects to add to the list, tab, comma or newline separated.","body":[{"contentType":"text/plain","example":"\"even skipped\"\nzen, bib\nhairless\n             "}],"URI":"/lists","parameters":[{"Type":"String","Description":"The name of the new list","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The description of the new list","Required":"N","Recommended":false,"Name":"description"},{"Options":"/model|model.classes","Type":"String","Description":"The type of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"String","Description":"A disambiguating value (such as organism name)","Required":"N","Recommended":false,"Name":"extraValue"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Create a new list","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service allows users to updated the\ndescription of lists belonging to them.\n            ","HTTPMethod":"PUT","RequiresAuthentication":"true","URI":"/lists","parameters":[{"Type":"String","Description":"The name of the list","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The new list's description","Required":"Y","Recommended":false,"Name":"newDescription"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Update the description of an existing list","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Lists","URI":"/service/lists"},{"identifier":"ws-rename-list","minVersion":4,"methods":[{"Description":"This service allows users to change the name of an existing list that\nthey are the owner of.\n      ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/lists/rename","parameters":[{"Options":"/lists|lists{authorized}","Type":"String","Description":"The current name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"oldname"},{"Type":"String","Description":"The name the list should have","Required":"Y","Recommended":false,"Name":"newname"}],"Synopsis":"Rename an Existing List","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service allows users to change the name of an existing list that\nthey are the owner of.\n      ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/lists/rename","parameters":[{"Options":"/lists|lists{authorized}","Type":"String","Description":"The current name of the list","Required":"Y","Recommended":false,"Default":"{name}","Name":"oldname"},{"Type":"String","Description":"The name the list should have","Required":"Y","Recommended":false,"Name":"newname"}],"Synopsis":"Rename an Existing List","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"List Renaming","URI":"/service/lists/rename"},{"identifier":"ws-lists-jaccard-index","minVersion":30,"methods":[{"Description":"This service compares the named list with all available lists. (public lists and\nprivate ones if the user is logged in). Its returns the name of each list\ncompared plus a number representing the Jaccard Index. See https://en.wikipedia.org/wiki/Jaccard_index\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/lists/jaccard-index","parameters":[{"Options":"/lists|lists{authorized}","Type":"String","Description":"The name of the list","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"The list of InterMine IDs","Required":"N","Recommended":false,"Name":"ids"},{"Type":"Float","Description":"If the Jaccard Index is lower than this value, discard","Required":"N","Recommended":false,"Default":"0.05","Name":"min"},{"Options":"/model|model.classes","Type":"String","Description":"The type of InterMine objects (if providing IDs)","Required":"N","Recommended":false,"Default":"{name}","Name":"type"}],"Synopsis":"Measure similarity of lists using Jaccard Index","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service compares the named list with all available lists. (public lists and\nprivate ones if the user is logged in). Its returns the name of each list\ncompared plus a number representing the Jaccard Index. See https://en.wikipedia.org/wiki/Jaccard_index\n                ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/lists/jaccard-index","parameters":[{"Options":"/lists|lists{authorized}","Type":"String","Description":"The name of the list","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"The list of InterMine IDs","Required":"N","Recommended":false,"Name":"ids"},{"Type":"Float","Description":"If the Jaccard Index is lower than this value, discard","Required":"N","Recommended":false,"Default":"0.05","Name":"min"},{"Options":"/model|model.classes","Type":"String","Description":"The type of InterMine objects (if providing IDs)","Required":"N","Recommended":false,"Default":"{name}","Name":"type"}],"Synopsis":"Measure similarity of lists using Jaccard Index","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Jaccard Index","URI":"/service/lists/jaccard-index"},{"identifier":"ws-template-upload","methods":[{"Description":"This service allows users to save templates they have authored on the server, associated\nwith their account. The templates once saved can be used as any other template query.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/template/upload","parameters":[{"Type":"String","Description":"One or more templates, serialised in XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"Integer","Description":"The version of the XML format","Required":"N","Recommended":false,"Default":"2","Name":"version"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","html","xml"],"Default":"text","Name":"format"}],"Synopsis":"Save a Template, or Overwrite an Existing One","returnFormats":[{"accept":"text/plain","Name":"text"},{"accept":"application/json","Name":"json"},{"accept":"text/html","Name":"html"},{"accept":"application/xml","Name":"xml"}]},{"Description":"This service allows users to save templates they have authored on the server, associated\nwith their account. The templates once saved can be used as any other template query.\n        ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/template/upload","parameters":[{"Type":"String","Description":"One or more templates, serialised in XML or JSON format.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"Integer","Description":"The version of the XML format","Required":"N","Recommended":false,"Default":"2","Name":"version"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","html","xml"],"Default":"text","Name":"format"}],"Synopsis":"Save a Template, or Overwrite an Existing One","returnFormats":[{"accept":"text/plain","Name":"text"},{"accept":"application/json","Name":"json"},{"accept":"text/html","Name":"html"},{"accept":"application/xml","Name":"xml"}]}],"name":"Template Upload","URI":"/service/template/upload"},{"identifier":"ws-template-results","methods":[{"DescriptionFormat":"markdown","Description":"Templates are predefined parameterised queries which may be run by supplying values and\noperators for the available editable constraints. The editable constraints vary from\ntemplate to template, so knowledge of these (obtainable by calls to `/templates`)\nis required to use this service correctly.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/template/results","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Type":"Integer","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Type":"Integer","Description":"The maximum size of the result set.","Required":"N","Recommended":false,"Default":"10","Name":"size"},{"Type":"enumerated","Description":"Include column headers. Use friendly for human readable paths. (Only for flat-file formats)","Required":"N","Recommended":false,"EnumeratedList":["none","path","friendly"],"Default":"none","Name":"columnheaders"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["tab","csv","count","json","jsonobjects","jsoncount","xml","html"],"Default":"tab","Name":"format"}],"Synopsis":"Get the results from running a template with a given set of parameters","returnFormats":[{"accept":"application/tsv","Name":"tab"},{"accept":"application/csv","Name":"csv"},{"accept":"text/count","Name":"count"},{"key":"results","accept":"application/json","Name":"json"},{"key":"results","accept":"application/json;type=objects","Name":"jsonobjects"},{"key":"count","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"application/xml","Name":"xml"},{"accept":"text/html","Name":"html"}]},{"DescriptionFormat":"markdown","Description":"Templates are predefined parameterised queries which may be run by supplying values and\noperators for the available editable constraints. The editable constraints vary from\ntemplate to template, so knowledge of these (obtainable by calls to `/templates`)\nis required to use this service correctly.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/template/results","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Type":"Integer","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Type":"Integer","Description":"The maximum size of the result set.","Required":"N","Recommended":false,"Default":"10","Name":"size"},{"Type":"enumerated","Description":"Include column headers. Use friendly for human readable paths. (Only for flat-file formats)","Required":"N","Recommended":false,"EnumeratedList":["none","path","friendly"],"Default":"none","Name":"columnheaders"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["tab","csv","count","json","jsonobjects","jsoncount","xml","html"],"Default":"tab","Name":"format"}],"Synopsis":"Get the results from running a template with a given set of parameters","returnFormats":[{"accept":"application/tsv","Name":"tab"},{"accept":"application/csv","Name":"csv"},{"accept":"text/count","Name":"count"},{"key":"results","accept":"application/json","Name":"json"},{"key":"results","accept":"application/json;type=objects","Name":"jsonobjects"},{"key":"count","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"application/xml","Name":"xml"},{"accept":"text/html","Name":"html"}]}],"name":"Template Results","URI":"/service/template/results"},{"identifier":"ws-template-to-list","methods":[{"DescriptionFormat":"markdown","Description":"This service allows the user to create a list from the result set of running a template\nwith a given set of parameters. The parameters for running the template are the same as when\nrequesting results (see documentation for `template-results`), and in addition to these\nparameters the user needs to supply a name and optional description for the list to be created.\n\nTo define which part of the template results to use, the user must supply a path parameter which\nindicates a valid column from the output to be used.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"POST","URI":"/template/tolist","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Options":"/templates|templates.$name.select","Type":"String","Description":"The path to use to compose the results. This should be one of the selected view paths.","Required":"Y","Recommended":false,"Default":"{}","Name":"path"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Type":"String","Description":"The name for the new list. There must be no existing list of this name","Required":"Y","Recommended":false,"Name":"listName"},{"Type":"String","Description":"A description to attach to the new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Create a List from the Output of a Template","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"DescriptionFormat":"markdown","Description":"This service allows the user to create a list from the result set of running a template\nwith a given set of parameters. The parameters for running the template are the same as when\nrequesting results (see documentation for `template-results`), and in addition to these\nparameters the user needs to supply a name and optional description for the list to be created.\n\nTo define which part of the template results to use, the user must supply a path parameter which\nindicates a valid column from the output to be used.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"POST","URI":"/template/tolist","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Options":"/templates|templates.$name.select","Type":"String","Description":"The path to use to compose the results. This should be one of the selected view paths.","Required":"Y","Recommended":false,"Default":"{}","Name":"path"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Type":"String","Description":"The name for the new list. There must be no existing list of this name","Required":"Y","Recommended":false,"Name":"listName"},{"Type":"String","Description":"A description to attach to the new list","Required":"N","Recommended":false,"Name":"description"},{"Type":"String[]","Description":"A set of tags to use to categorise the new list","Required":"N","Recommended":false,"Name":"tags"},{"Type":"boolean","Description":"Whether or not to replace any existing list of this name","Required":"N","Recommended":false,"Default":"false","Name":"replaceExisting"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Create a List from the Output of a Template","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Template to list","URI":"/service/template/tolist"},{"identifier":"ws-template-append","minVersion":4,"methods":[{"DescriptionFormat":"markdown","Description":"This service allows the user to add items to a list from the result set of running a template\nwith a given set of parameters. The parameters for running the template are the same as when\nrequesting results, and in addition to these parameters the user needs to supply the name\nof a list to append the results to.\n\nTo define which part of the template results to use, the user must supply a path parameter which\nindicates a valid column from the output to be used.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"POST","RequiresAuthentication":"true","ALSO":"GET","URI":"/template/append/tolist","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Options":"/templates|templates.$name.select","Type":"String","Description":"The path to use to compose the results. This should be one of the selected view paths.","Required":"Y","Recommended":false,"Default":"{}","Name":"path"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Options":"/lists|lists{authorized}","Type":"String","Description":"The name of the list to add items to.","Required":"Y","Recommended":false,"Default":"{name}","Name":"listName"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Add items to a list from a set of results from running a template","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"DescriptionFormat":"markdown","Description":"This service allows the user to add items to a list from the result set of running a template\nwith a given set of parameters. The parameters for running the template are the same as when\nrequesting results, and in addition to these parameters the user needs to supply the name\nof a list to append the results to.\n\nTo define which part of the template results to use, the user must supply a path parameter which\nindicates a valid column from the output to be used.\n\nUsers should provide parameters of the form `constraint{N}`, `op{N}`, `value{N}`\nand `extra{N}` for each editable contraint, where `N` represents a number to group\nthe values. The value of the `constraint{N}` parameter serves to identify\nthe constraint, and may not be changed. Values for `op{N}` and `value{N}` must be\ngiven, and may be anything the user requires.\n\nTo run a template, for example which has the following editable constraints:\n```\n<constraint path=\"Gene.symbol\" op=\"=\" value=\"eve\" editable=\"true\"/>\n<constraint path=\"Gene.length\" op=\"&gt;\" value=\"1000\" editable=\"true\"/>\n```\n\nThen the user should supply the following parameters to run it with the above values:\n\n| Parameter           | Value            |\n|---------------------|------------------|\n| constraint1         | Gene.symbol      |\n| op1                 | eq               |\n| value1              | eve              |\n| constraint2         | Gene.length      |\n| op2                 | gt               |\n| value2              | 1000             |\n\nThe value of the number used to identify each constraint is ignored - it must however be\nconsistent for each parameter. One set of template constraint parameters is required\nfor each editable constraint on the query. These are not required for optional constraints.\n        ","HTTPMethod":"GET","RequiresAuthentication":"true","ALSO":"GET","URI":"/template/append/tolist","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to run","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Options":"/templates|templates.$name.select","Type":"String","Description":"The path to use to compose the results. This should be one of the selected view paths.","Required":"Y","Recommended":false,"Default":"{}","Name":"path"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint paths","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{path}","Name":"constraint{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint operators","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{op}","Name":"op{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint values","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{value}","Name":"value{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply constraint codes. Codes are only required if two constraints have the same path.","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{code}","Name":"code{N}"},{"Type":"String[]","Description":"One of a variable set of parameters used to supply extra constraint values (used by LOOKUP constraints)","Required":"N","Recommended":false,"Repeat":"/templates|templates.$name.where{editable}","Default":"{extraValue}","Name":"extra{N}"},{"Options":"/lists|lists{authorized}","Type":"String","Description":"The name of the list to add items to.","Required":"Y","Recommended":false,"Default":"{name}","Name":"listName"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Add items to a list from a set of results from running a template","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Append to List from Template Results","URI":"/service/template/append/tolist"},{"identifier":"ws-template","methods":[{"DescriptionFormat":"markdown","Description":"Get a listing of the templates configured in an InterMine instance.\nEach template contains a description of its properties, defining the\nparameters that must be provided to run it, as well as a definition of the\noutput format for its results.\n\nIf the request is authenticated to a user, then the templates that that has access\nto will also be returned.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/templates","parameters":[{"Type":"boolean","Description":"Whether or not to include invalid templates. Invalid templates cannot be run.","Required":"N","Recommended":false,"Default":"false","Name":"includeBroken"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["xml","json"],"Default":"xml","Name":"format"}],"Synopsis":"Get the list of available templates.","returnFormats":[{"Name":"xml"},{"key":"templates","Name":"json"}]},{"Description":"Upload a set of templates to the current user profile.\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"The templates to upload. If using body content.","body":[{"contentType":"application/xml","example":"<template name=\"my-new-template\">\n    <query model=\"genomic\" view=\"Gene.symbol Gene.proteins.proteinDomains.name\">\n        <constraint editable=\"true\" path=\"Gene\" op=\"LOOKUP\" value=\"eve\"/>\n    <\/query>\n<\/template>\n             "}],"URI":"/templates","parameters":[{"Type":"String","Description":"The xml or JSON to load, if using form parameters.","Required":"N","Recommended":false,"Default":"","Name":"xml"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["xml","json"],"Default":"xml","Name":"format"}],"Synopsis":"Upload one or more templates.","returnFormats":[{"Name":"xml"},{"Name":"json"}]}],"name":"Templates","URI":"/service/templates"},{"identifier":"ws-model","methods":[{"Description":"An InterMine data model can be fully described as a set of classes\nwith various properties. This data model is useful for constructing\nqueries and interpreting the results returned from the service.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/model","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["xml","json"],"Default":"xml","Name":"format"}],"Synopsis":"Get a description of the data model","returnFormats":[{"Name":"xml"},{"key":"model","Name":"json"}]}],"name":"Data Model","URI":"/service/model"},{"identifier":"ws-version","methods":[{"Description":"Get the web-service version number. This number is incremented for\neach change in functionality.\n           ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/version","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json"],"Default":"text","Name":"format"}],"Synopsis":"Get the Web-Service Version.","returnFormats":[{"Name":"text"},{"key":"version","Name":"json"}]},{"Description":"Get the release version of the data-warehouse. This is a string that is changed\neach time data is added or removed from the server. Thus this number is meant\nto reflect the contents rather than the interface of this set of services.\n           ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/version/release","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json"],"Default":"text","Name":"format"}],"Synopsis":"Get the Data-Warehouse Release Version.","returnFormats":[{"Name":"text"},{"key":"version","Name":"json"}]},{"Description":"Get the InterMine version number. This number represents the version of InterMine\ncode currently running. See https://github.com/intermine/intermine/releases for\nfull details on release dates and versions.\n           ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/version/intermine","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json"],"Default":"text","Name":"format"}],"Synopsis":"Get the InterMine Release Version.","returnFormats":[{"Name":"text"},{"key":"version","Name":"json"}]}],"name":"Version","URI":"/service/version"},{"identifier":"ws-check-resource","methods":[{"Description":"This service is deprecated. Use the full service listing instead.\n            ","HTTPMethod":"GET","URI":"/check/:resource","parameters":[{"Type":"String","Description":"The resource to locate","Required":"Y","Recommended":false,"Name":"resource"}],"Synopsis":"Find out where a resource is mounted","returnFormats":[{"accept":"text/plain","Name":"text"}]}],"name":"Check Resource","URI":"/service/check"},{"identifier":"ws-possible-values","minVersion":6,"methods":[{"Description":"This service provides the possible values that a path may represent\nin the database. This functionality is expected to primarily useful for\napplications providing completion and suggestions for user-input.\n           ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/path/values","parameters":[{"Type":"String","Description":"The path whose possible values are requested","Required":"Y","Recommended":false,"Name":"path"},{"Type":"JSON","Description":"A json object mapping which describes the type constraints on this path","Required":"N","Recommended":false,"Name":"typeConstraints"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","jsoncount","count"],"Default":"json","Name":"format"}],"Synopsis":"Get the possible values a path may have.","returnFormats":[{"key":"results","accept":"application/json","Name":"json"},{"key":"count","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"text/plain;type=count","Name":"count"}]},{"Description":"This service provides the possible values that a path may represent\nin the database. This functionality is expected to primarily useful for\napplications providing completion and suggestions for user-input.\n           ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/path/values","parameters":[{"Type":"String","Description":"The path whose possible values are requested","Required":"Y","Recommended":false,"Name":"path"},{"Type":"JSON","Description":"A json object mapping which describes the type constraints on this path","Required":"N","Recommended":false,"Name":"typeConstraints"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","jsoncount","count"],"Default":"json","Name":"format"}],"Synopsis":"Get the possible values a path may have.","returnFormats":[{"key":"results","accept":"application/json","Name":"json"},{"key":"count","accept":"application/json;type=count","Name":"jsoncount"},{"accept":"text/plain;type=count","Name":"count"}]}],"name":"Possible Values","URI":"/service/path/values"},{"identifier":"ws-schemata","minVersion":6,"methods":[{"Description":"Get a listing of the available schemata","HTTPMethod":"GET","MethodName":"All Schemata","URI":"/schema","parameters":[],"Synopsis":"Get all Schemata","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"Retrieve a specific schema","HTTPMethod":"GET","MethodName":"One Schema","URI":"/schema/:name","parameters":[{"Options":"/schema|schemata","Description":"The name of the schema to retrieve","Required":"Y","Recommended":false,"Default":"{}","Name":"name"}],"Synopsis":"Get one Schema"}],"name":"Schemata","URI":"/service/schema"},{"identifier":"ws-summary-fields","minVersion":7,"methods":[{"HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/summaryfields","parameters":[{"Type":"Boolean","Description":"Whether to exclude references from the summary fields","Required":"N","Recommended":false,"Default":"false","Name":"norefs"}],"Synopsis":"Get the fields used to summarise the class","returnFormats":[{"key":"classes","Name":"json"}]}],"name":"Summary Fields","URI":"/service/summaryfields"},{"identifier":"ws-code-gen","minVersion":7,"methods":[{"Description":"This service provides the ability to generate code in one of several\nlanguages based on a pathquery provided in serialised form.\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/query/code","parameters":[{"Type":"enumerated","Description":"The language to generate code in.","Required":"Y","Recommended":false,"EnumeratedList":["pl","py","rb","js","java"],"Default":"py","Name":"lang"},{"Type":"String","Description":"The query to generate code for, in XML or JSON form.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","xml"],"Default":"text","Name":"format"}],"Synopsis":"Get the code to run a pathquery in a given language.","returnFormats":[{"accept":"text/plain","Name":"text"},{"key":"code","accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]},{"Description":"This service provides the ability to generate code in one of several\nlanguages based on a pathquery provided in serialised form.\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/query/code","parameters":[{"Type":"enumerated","Description":"The language to generate code in.","Required":"Y","Recommended":false,"EnumeratedList":["pl","py","rb","js","java"],"Default":"py","Name":"lang"},{"Type":"String","Description":"The query to generate code for, in XML or JSON form.","Required":"Y","Recommended":false,"Name":"query"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","xml"],"Default":"text","Name":"format"}],"Synopsis":"Get the code to run a pathquery in a given language.","returnFormats":[{"accept":"text/plain","Name":"text"},{"key":"code","accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]}],"name":"Generated Code","URI":"/service/query/code"},{"identifier":"ws-list-tags","minVersion":7,"methods":[{"Description":"Fetch an up-to-date list of all tags associated with a list, or all lists.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/list/tags","parameters":[{"Type":"String","Description":"The name of a list whose tags to retrieve. If no list is provided, then all the tags associated with the authenticating user will be returned.","Required":"N","Recommended":false,"Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Get the tags for a list, or all the tags for a given user","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]},{"HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/list/tags","parameters":[{"Type":"String","Description":"The name of a list to add the tag(s) to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The name of the tags to add. It should take to from of a semi-colon delimited concatenation of the tag names.","Required":"Y","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Add one or more tags to a list","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]},{"HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/list/tags","parameters":[{"Type":"String","Description":"The name of a list to add the tag(s) to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The name of the tags to remove. It should take to from of a semi-colon delimited concatenation of the tag names.","Required":"Y","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Delete one or more tags from a list","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]}],"name":"List Tags","URI":"/service/list/tags"},{"identifier":"ws-available-widgets","minVersion":8,"methods":[{"Description":"This service returns a list of the widgets that are available at a\ngiven service. Each entry for the widget includes details of its type,\nthe kind of data it processes, and any filters it accepts.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/widgets","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Get a list of the widgets available at a service","returnFormats":[{"key":"widgets","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]}],"name":"Widgets","URI":"/service/widgets"},{"identifier":"ws-widgets","minVersion":8,"methods":[{"Description":"Enrichment widgets provide a statistical summary of what makes a list distinct from\nthe background population over a certain domain. They return a list of members of the\ndomain ranked by p-value (low to high).\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/enrichment","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to investigate, optional unless identifiers is NULL.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Options":"/widgets|widgets{widgetType=enrichment}","Type":"String","Description":"The name of the enrichment widget to display","Required":"Y","Recommended":false,"Default":"{name}","Name":"widget"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to use as the background population","Required":"N","Recommended":false,"Default":"{name}","Name":"population"},{"Type":"Float","Description":"The maximum p-value of results to display. The range is 0.0 - 1.0","Required":"Y","Recommended":false,"Default":"0.05","Name":"maxp"},{"Type":"enumerated","Description":"The error correction algorithm to use.","Required":"Y","Recommended":false,"EnumeratedList":["Holm-Bonferroni","Benjamini and Hochberg","Bonferroni","None"],"Default":"Holm-Bonferroni","Name":"correction"},{"Options":"/widgets|widgets{name=$name}.0.filters","Type":"String","Description":"An optional filter that some widgets accept","Required":"N","Recommended":false,"Name":"filter"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"get the data for a given enrichment widget","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]},{"Description":"Enrichment widgets provide a statistical summary of what makes a list distinct from\nthe background population over a certain domain. They return a list of members of the\ndomain ranked by p-value (low to high).\n            ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/enrichment","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to investigate, optional unless identifiers is NULL.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Options":"/widgets|widgets{widgetType=enrichment}","Type":"String","Description":"The name of the enrichment widget to display","Required":"Y","Recommended":false,"Default":"{name}","Name":"widget"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to use as the background population","Required":"N","Recommended":false,"Default":"{name}","Name":"population"},{"Type":"Float","Description":"The maximum p-value of results to display. The range is 0.0 - 1.0","Required":"Y","Recommended":false,"Default":"0.05","Name":"maxp"},{"Type":"enumerated","Description":"The error correction algorithm to use.","Required":"Y","Recommended":false,"EnumeratedList":["Holm-Bonferroni","Benjamini and Hochberg","Bonferroni","None"],"Default":"Holm-Bonferroni","Name":"correction"},{"Options":"/widgets|widgets{name=$name}.0.filters","Type":"String","Description":"An optional filter that some widgets accept","Required":"N","Recommended":false,"Name":"filter"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"get the data for a given enrichment widget","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]}],"name":"Enrichment Widgets","URI":"/service/list/enrichment"},{"identifier":"ws-list-graphs","minVersion":8,"methods":[{"Description":"This service returns data that can be passed to charting software, such\nas Google's javascript Charts API, to produce graphical representations\nof the overview of data in a list.\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/chart","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to investigate","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Type":"String","Description":"Type of the entities, required when ids is used","Required":"N","Recommended":false,"Name":"type"},{"Options":"/widgets|widgets{widgetType=chart}","Type":"String","Description":"The name of the graphical widget to display","Required":"Y","Recommended":false,"Default":"{name}","Name":"widget"},{"Type":"String","Description":"An optional filter that some widgets accept","Required":"N","Recommended":false,"Name":"filter"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"get the data to produce a graph","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"}]},{"Description":"This service returns data that can be passed to charting software, such\nas Google's javascript Charts API, to produce graphical representations\nof the overview of data in a list.\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/chart","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to investigate","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Type":"String","Description":"Type of the entities, required when ids is used","Required":"N","Recommended":false,"Name":"type"},{"Options":"/widgets|widgets{widgetType=chart}","Type":"String","Description":"The name of the graphical widget to display","Required":"Y","Recommended":false,"Default":"{name}","Name":"widget"},{"Type":"String","Description":"An optional filter that some widgets accept","Required":"N","Recommended":false,"Name":"filter"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"get the data to produce a graph","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"}]}],"name":"Graphical Widgets","URI":"/service/list/chart"},{"identifier":"ws-list-table","minVersion":8,"methods":[{"Description":"This service returns data to produce a table representations\nof the overview of data in a list.\n          ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/table","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to use as the population for the graph","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Type":"String","Description":"The name of the graphical widget to display","Required":"Y","Recommended":false,"Name":"widget"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Get the data as displayed by a table widget","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"}]},{"Description":"This service returns data to produce a table representations\nof the overview of data in a list.\n          ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/list/table","parameters":[{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"The name of the list to use as the population for the graph","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"Comma-separated list of InterMine object IDs, optional unless list name is NULL.","Required":"N","Recommended":false,"Name":"ids"},{"Type":"String","Description":"The name of the graphical widget to display","Required":"Y","Recommended":false,"Name":"widget"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Get the data as displayed by a table widget","returnFormats":[{"key":"results","Name":"json"},{"Name":"xml"}]}],"name":"Table Widgets","URI":"/service/list/table"},{"identifier":"ws-facet-search","minVersion":9,"methods":[{"Description":"Run a general key-word style search over all data in the data-warehouse.\nThis is similar to Quick Search but here only the facet category counts are returned.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/facets","parameters":[{"Type":"String","Description":"The query string to search with. If absent, or blank, all results will be returned","Required":"N","Recommended":false,"Name":"q"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"A list to search within.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String[]","Description":"A facet parameter, eg facet_Organism=D.melanogaster","Required":"N","Recommended":false,"Name":"facet_?"}],"Synopsis":"Perform a key-word search and retrieve the facets","returnFormats":[{"key":"facets","Name":"json"}]},{"Description":"Run a general key-word style search over all data in the data-warehouse.\nThis is similar to Quick Search but here only the facet category counts are returned.\n                ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/facets","parameters":[{"Type":"String","Description":"The query string to search with. If absent, or blank, all results will be returned","Required":"N","Recommended":false,"Name":"q"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"A list to search within.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String[]","Description":"A facet parameter, eg facet_Organism=D.melanogaster","Required":"N","Recommended":false,"Name":"facet_?"}],"Synopsis":"Perform a key-word search and retrieve the facets","returnFormats":[{"key":"facets","Name":"json"}]}],"name":"FacetSearch","URI":"/service/facets"},{"identifier":"ws-facet-list","minVersion":9,"methods":[{"Description":"Retreive all the possible facets.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/facet-list","parameters":[],"Synopsis":"Retreive all the possible facets","returnFormats":[{"key":"facetlist","Name":"json"}]}],"name":"FacetList","URI":"/service/facet-list"},{"identifier":"ws-quick-search","minVersion":9,"methods":[{"Description":"Run a general key-word style search over all data in the data-warehouse.\nRather than a structured query for a specific type of data, this allows\nthe user to search broadly over a range of data types, and use\nfacetting information to restrict the search results.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","ALSO":"POST","URI":"/search","parameters":[{"Type":"String","Description":"The query string to search with. If absent, or blank, all results will be returned","Required":"N","Recommended":false,"Name":"q"},{"Type":"int","Description":"The maximum number of records to return. If no limit is provided, up to 100 results will be returned.","Required":"N","Recommended":false,"Default":"10","Name":"size"},{"Type":"int","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"A list to search within.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String[]","Description":"A facet parameter, eg facet_Organism=D.melanogaster","Required":"N","Recommended":false,"Name":"facet_?"}],"Synopsis":"Perform a key-word search and retrieve the results","returnFormats":[{"key":"results","Name":"json"}]},{"Description":"Run a general key-word style search over all data in the data-warehouse.\nRather than a structured query for a specific type of data, this allows\nthe user to search broadly over a range of data types, and use\nfacetting information to restrict the search results.\n            ","HTTPMethod":"POST","RequiresAuthentication":"false","ALSO":"POST","URI":"/search","parameters":[{"Type":"String","Description":"The query string to search with. If absent, or blank, all results will be returned","Required":"N","Recommended":false,"Name":"q"},{"Type":"int","Description":"The maximum number of records to return. If no limit is provided, up to 100 results will be returned.","Required":"N","Recommended":false,"Default":"10","Name":"size"},{"Type":"int","Description":"The index of the first result to return.","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Options":"/lists|lists{status=CURRENT}","Type":"String","Description":"A list to search within.","Required":"N","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String[]","Description":"A facet parameter, eg facet_Organism=D.melanogaster","Required":"N","Recommended":false,"Name":"facet_?"}],"Synopsis":"Perform a key-word search and retrieve the results","returnFormats":[{"key":"results","Name":"json"}]}],"name":"QuickSearch","URI":"/service/search"},{"identifier":"ws-whoami","minVersion":9,"methods":[{"Description":"Retrieve information about the currently authenticated user. This can\nbe used to display the user's name.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user/whoami","parameters":[],"Synopsis":"Get details about the authenticated user","returnFormats":[{"key":"user","Name":"json"}]}],"name":"Who-Am-I?","URI":"/service/user/whoami"},{"identifier":"ws-24hr-token","minVersion":9,"methods":[{"Description":"This service allows a user to retrieve an API token which is valid\nfor up to 24 hours of unlimited use. The primary use case is to\nget an API key where the user has only username/password credentials,\nsince the use of API keys is more secure.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user/token","parameters":[],"Synopsis":"Get a new API key","returnFormats":[{"key":"token","Name":"json"}]}],"name":"Token","URI":"/service/user/token"},{"identifier":"ws-new-user","minVersion":9,"methods":[{"Description":"This service allows users of the web service to create a new user account.\nA user account is required for a number of operations, such as saving\nlists. This service allows users of the webservice to register an account, and\nstart using these features that require authentication. The username and\npassword provided will be able to be used for future requests, as will\nan API key provided with the response, which is valid for 24 hours.\n    This is equivalent to the registration mechanism in the web-application interface.\n    Requests to this service are rate limited by IP Address\n","HTTPMethod":"POST","RequiresAuthentication":"false","MethodName":"User Creation","URI":"/users","parameters":[{"Type":"Email","Description":"The user name of the new user. It should be an email address if possible. There must not be any user with the same username","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"A password to associate with the account.","Required":"Y","Recommended":false,"Name":"password"},{"Type":"boolean","Description":"Whether or not to subscribe to the mine's mailing list, if it has one. The username must be an email address if true","Required":"N","Recommended":false,"Name":"subscribe-to-list"}],"Synopsis":"Create a new user in the user-profile","returnFormats":[{"key":"user","Name":"json"}]}],"name":"Users","URI":"/service/users"},{"identifier":"ws-classkeys","minVersion":9,"methods":[{"Description":"Get the fields configured for this service to identify objects uniquely within\nthe database.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/classkeys","parameters":[],"Synopsis":"Get the fields used to identify an object","returnFormats":[{"key":"classes","Name":"json"}]}],"name":"Key Fields","URI":"/service/classkeys"},{"identifier":"ws-id-resolver","minVersion":10,"methods":[{"DescriptionFormat":"markdown","Description":"New ID resolution jobs are created by posting a representation of the job to this\nservice. Jobs are run asynchronously, so this service simply submits the\njob, and returns the identifier of the job, so that its results and status\nmay be polled later.\n\nA job is a data structure (represented as `json`) that satisfies the\nfollowing [json-schema](http://json-schema.org/) schema:\n\n```\n{\n    \"type\": \"object\",\n    \"required\": [\"identifiers\", \"type\"],\n    \"properties\": {\n        \"identifiers\": {\n            \"type\": \"array\",\n            \"items\": { \"type\": \"string\" },\n            \"minItems\": 1,\n            \"uniqueItems\": true\n        },\n        \"type\":          { \"type\": \"string\"  },\n        \"extra\":         { \"type\": \"string\"  },\n        \"caseSensitive\": { \"type\": \"boolean\" },\n        \"wildCards\":     { \"type\": \"boolean\" }\n    }\n}\n```\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"A representation of the job. This must include a list of identifiers to resolve, and the type of object these ids are meant to resolve to","MethodName":"Submit Job","body":[{"schema":"/schema/job.schema","contentType":"application/json","example":"{\n  \"identifiers\": [\"eve\", \"zen\", \"bib\"],\n  \"type\": \"Gene\",\n  \"caseSensitive\": true,\n  \"wildCards\": true,\n  \"extra\": \"D. melanogaster\"\n}\n              "}],"URI":"/ids","parameters":[],"Synopsis":"Start a New ID Resolution Job on the Server","returnFormats":[{"key":"uid","Name":"json"}]},{"Description":"Get a representation of the status of job.","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Check Job Status","URI":"/ids/:uid/status","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Check the Status of a Given Job","returnFormats":[{"key":"status","accept":"application/json","Name":"json"}]},{"Description":"Get the full results of running a specific job.","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Retrieve Job Results","URI":"/ids/:uid/results","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Get the Results of a Given Job","returnFormats":[{"key":"results","accept":"application/json","Name":"json"}]},{"Description":"Each job should be removed from the server when the user has finished inspecting the results.","HTTPMethod":"DELETE","RequiresAuthentication":"true","MethodName":"Delete A Job","URI":"/ids/:uid","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Delete a given job from the server.","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"ID Resolution","URI":"/service/ids"},{"identifier":"ws-list-invitations","minVersion":11,"methods":[{"DescriptionFormat":"markdown","Description":"This service allows users to share one of their lists with another user.\nThis allows read-only access to the given list, allowing it to be used in\nqueries, exported, etc. You should only do this if you trust the other\nparty with your data.\n Users can be designated by their username, display-name (if set) or by\nand email address. If the email address is not registered with a user in\nthe system, an invitation will be sent to that address, with a code that\nallows the user to activate the list share.\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Invitation Creation","URI":"/lists/invitations","parameters":[{"Options":"/lists|lists{status=CURRENT,authorized}","Type":"String","Description":"The list of yours you wish to share","Required":"Y","Recommended":false,"Default":"{name}","Name":"list"},{"Type":"String","Description":"The email address of the user to invite to share a list.","Required":"Y","Recommended":false,"Name":"to"},{"Type":"boolean","Description":"Whether or not to send an email to the invitee. The invitee value must be an email address if true","Required":"N","Recommended":false,"Default":"false","Name":"notify"}],"Synopsis":"Invite another user to share a list","returnFormats":[{"key":"invitation","Name":"json"}]},{"Description":"This service returns a description of all the outstanding list invitations\nfor a user on the system.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Invitation Details","URI":"/lists/invitations","parameters":[],"Synopsis":"Details of all outstanding invitations","returnFormats":[{"key":"invitation","Name":"json"}]},{"Description":"This service returns details of a single invitation on the system.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Invitation Details","URI":"/lists/invitations/:uid","parameters":[{"Type":"String","Description":"The identifier of the invitation - a 20 character unique string","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Details of a single invitation","returnFormats":[{"key":"invitation","Name":"json"}]},{"Description":"The service accepts the invitation, activating the share. It must be accessed\nby the user it was sent to.\n          ","HTTPMethod":"PUT","RequiresAuthentication":"true","MethodName":"Invitation Acceptance","URI":"/lists/invitations/:uid","parameters":[{"Type":"String","Description":"The identifier of the invitation - a 20 character unique string","Required":"Y","Recommended":false,"Name":"uid"},{"Type":"boolean","Description":"Whether or not this invitation is accepted or not.","Required":"Y","Recommended":false,"Name":"accepted"}],"Synopsis":"Declare the acceptance of an invitation.","returnFormats":[{"key":"invitation","Name":"json"}]}],"name":"List Invitations","URI":"/service/lists/invitations"},{"identifier":"ws-list-shares","minVersion":11,"methods":[{"Description":"This service provides a means for authorising another user to access a list. To\nshare a list the user making the request must be the owner of the list and you must\nknow the username of the user you wish to share with. If you do not know the username\nof the user to share with, then the user should issue an invitation instead. The user\nthe list is shared with must exist and the list must not already be shared with them.\n The service returns information detailing whom the list in question is currently\nshared with.\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Share a List","URI":"/lists/shares","parameters":[{"Type":"String","Description":"The list of yours you wish to share.","Required":"Y","Recommended":false,"Name":"list"},{"Type":"String","Description":"The username of the user who will have access.","Required":"Y","Recommended":false,"Name":"with"},{"Type":"boolean","Description":"Whether or not to send an email to the user you are sharing with.","Required":"N","Recommended":false,"Name":"notify"}],"Synopsis":"Authorise another user to access a list","returnFormats":[{"key":"share","accept":"application/javascript","Name":"json"}]},{"Description":"Get information about each list that is shared by or with the authenticating\nuser. The service returns a map with two keys \"sharedByUser\" and \"sharedWithUser\"\nwhich are themselves each maps, with list names as keys, and either lists of\nusers with access as values, or the name of the original owner as values.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Details of Currently Shared Lists","URI":"/lists/shares","parameters":[],"Synopsis":"Retrieve information about which lists are shared with and by whom.","returnFormats":[{"key":"share","accept":"application/javascript","Name":"json"}]},{"Description":"Stop a user from being able to access a list that you own. This service allows a user\nto remove a user's previously granted permission to view the contents of a list.\n Other than a json results envelope no meaningful results are returned, and the caller\nshould simply check for a successful response.\n          ","HTTPMethod":"DELETE","RequiresAuthentication":"true","MethodName":"Stop Sharing a List","URI":"/lists/shares","parameters":[],"Synopsis":"Rescind the Permission Granted to a User to Access a List.","returnFormats":[{"accept":"application/javascript","Name":"json"}]}],"name":"List Sharing","URI":"/service/lists/shares"},{"identifier":"ws-user-preferences","minVersion":11,"methods":[{"Description":"Thid service allows a user to store or change a key value pair\nassociated with their account. The keys may have a particular meaning. All values\nwill be stored and retrieved as strings.\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Set Preference(s)","URI":"/user/preferences","parameters":[{"Type":"String[]","Description":"The preference to set","Required":"N","Recommended":false,"Name":"?"}],"Synopsis":"Set the value of one or more preferences","returnFormats":[{"key":"preferences","Name":"json"}]},{"Description":"Get a complete listing of a user's preferences. This is presented as a mapping\nfrom string key to string value.\n          ","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"View Preferences","URI":"/user/preferences","parameters":[],"Synopsis":"Get a user's preferences","returnFormats":[{"key":"preferences","Name":"json"}]},{"Description":"Delete either a single preference from a user's set of stored preferences, or deletes\nall stored preference values.\n          ","HTTPMethod":"DELETE","RequiresAuthentication":"true","MethodName":"Delete Preference(s)","URI":"/user/preferences","parameters":[{"Type":"String","Description":"The preference to delete. If not provided, ALL will be cleared","Required":"N","Recommended":false,"Name":"key"}],"Synopsis":"Remove one or all preferences.","returnFormats":[{"key":"preferences","Name":"json"}]}],"name":"User Preferences","URI":"/service/user/preferences"},{"identifier":"ws-query-store","minVersion":12,"methods":[{"Description":"Get a query stored at the service.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/queries","parameters":[{"Type":"String","Description":"The id of the query to fetch","Required":"Y","Recommended":false,"Name":"id"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Get a stored query","returnFormats":[{"Name":"json"},{"Name":"xml"}]},{"HTTPMethod":"POST","RequiresAuthentication":"false","URI":"/queries","parameters":[{"Type":"String","Description":"The xml OR JSON of the query to store.","Required":"Y","Recommended":false,"Name":"query"}],"Synopsis":"Store a query","returnFormats":[{"key":"id","Name":"json"}]}],"name":"Query Store","URI":"/service/queries"},{"identifier":"ws-sequence","minVersion":13,"methods":[{"DescriptionFormat":"markdown","Description":"Get either the entire sequence of an object, or\nfetch an indexed sub-sequence of it.\n\nThis service expects a query with a single output column that resolves\nto a sub-sequenceable object. For example to get a sub-sequence\nof the genomic sequence of the fly X chromosome in a genomic mine, the following\nquery could be used:\n\n```\n<query model=\"genomic\" view=\"Chromosome.sequence.residues\">\n    <constraint path=\"Chromosome\" op=\"LOOKUP\" value=\"X\" extraValue=\"D. melanogaster\"/>\n<\/query>\n```\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/sequence","parameters":[{"Type":"Integer","Description":"The start index","Required":"N","Recommended":false,"Default":"0","Name":"start"},{"Type":"Integer","Description":"The end index","Required":"N","Recommended":false,"Name":"end"},{"Type":"String","Description":"The xml OR JSON of the query to run.","Required":"Y","Recommended":false,"Default":"<query model=\"genomic\" view=\"Chromosome.sequence.residues\">     <constraint path=\"Chromosome\" op=\"LOOKUP\" value=\"X\" extraValue=\"D. melanogaster\"/> <\/query>","Name":"query"}],"Synopsis":"Get a portion of a sequence-like object.","returnFormats":[{"key":"results","Name":"json"}]}],"name":"Sequence Access","URI":"/service/sequence"},{"identifier":"ws-jbrowse","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` feature\nrequests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Features","URI":"/jbrowse/:domain/features/:refseq","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"},{"Options":"/data/Chromosome|results{length}","Type":"String","Description":"The identifier of the reference sequence to find                     features within","Required":"Y","Recommended":false,"Default":"{primaryIdentifier}","Name":"refseq"},{"Type":"Integer","Description":"The starting index","Required":"N","Recommended":true,"Default":"100000","Name":"start"},{"Type":"Integer","Description":"The end index","Required":"N","Recommended":true,"Default":"120000","Name":"end"},{"Options":"/model|model.classes","Type":"String","Description":"The type of feature to return","Required":"N","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"boolean","Description":"Make this a reference sequence request","Required":"N","Recommended":false,"Default":"false","Name":"reference"}],"Synopsis":"Get Features on a Reference Sequence","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` global statistics\nrequests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Global Statistics","URI":"/jbrowse/:domain/stats/global","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"},{"Options":"/model|model.classes","Type":"String","Description":"The type of feature we are interested in","Required":"N","Recommended":false,"Default":"{name}","Name":"type"}],"Synopsis":"Get Statistics about the Features Served by this Store","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` region statistics\nrequests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Region Statistics","URI":"/jbrowse/:domain/stats/region/:refseq","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"},{"Options":"/data/Chromosome|results{length}","Type":"String","Description":"The identifier of the reference sequence to find                     features within","Required":"Y","Recommended":false,"Default":"{primaryIdentifier}","Name":"refseq"},{"Type":"Integer","Description":"The starting index","Required":"N","Recommended":false,"Default":"1000","Name":"start"},{"Type":"Integer","Description":"The end index","Required":"N","Recommended":false,"Default":"2000","Name":"end"},{"Options":"/model|model.classes","Type":"String","Description":"The type of feature we are interested in","Required":"N","Recommended":false,"Default":"{name}","Name":"type"}],"Synopsis":"Get Statistics for a Sub-Set of Features Served by this Store","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` binned\nregion statistics requests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Region Statistics","URI":"/jbrowse/:domain/stats/regionFeatureDensities/:refseq","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"},{"Options":"/data/Chromosome|results{length}","Type":"String","Description":"The identifier of the reference sequence to find                     features within","Required":"Y","Recommended":false,"Default":"{primaryIdentifier}","Name":"refseq"},{"Type":"Integer","Description":"The starting index","Required":"N","Recommended":false,"Default":"1000","Name":"start"},{"Type":"Integer","Description":"The end index","Required":"N","Recommended":false,"Default":"2000","Name":"end"},{"Options":"/model|model.classes","Type":"String","Description":"The type of feature we are interested in","Required":"N","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"String","Description":"The number of bases per bin, used to determine the number of bins","Required":"N","Recommended":false,"Default":"20000","Name":"basesPerBin"}],"Synopsis":"Get Binned Density Statistics for a Sub-Set of Features Served by this Store","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"JBrowse Endpoint","URI":"/service/jbrowse"},{"identifier":"ws-jbrowse-names","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` name\nlook-up requests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Find Features By Name","URI":"/jbrowse/names/:domain","parameters":[{"Type":"String","Description":"The search prefix string to look for","Required":"Y","Recommended":false,"Default":"eve","Name":"startswith"},{"Options":"/data/Organism|results","Type":"String","Description":"The domain for this search (generally an organism)","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"}],"Synopsis":"Lookup features by name","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service provides the functionality for `JBrowse` name\nlook-up requests.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Retrieve Feature Information","URI":"/jbrowse/names/:domain","parameters":[{"Type":"String","Description":"The name of the item.","Required":"Y","Recommended":false,"Default":"eve","Name":"equals"},{"Options":"/data/Organism|results","Type":"String","Description":"The domain for this search (generally an organism)","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"}],"Synopsis":"Retrieve feature information by name","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"JBrowse Name Lookup","URI":"/service/jbrowse/names"},{"identifier":"ws-deregistration-token","minVersion":16,"methods":[{"Description":"This service returns a representation of a deregistration\ntoken that a user has access to.\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user/deregistration/:uid","parameters":[{"Type":"String","Description":"The identifier of the token","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Get information about a deregistration token","returnFormats":[{"key":"token","accept":"application/json","Name":"json"}]},{"Description":"This service creates a deregistration token,\nthus starting the process of de-registerin a user.\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/user/deregistration","parameters":[],"Synopsis":"Create a deregistration token","returnFormats":[{"key":"token","accept":"application/json","Name":"json"}]},{"Description":"This service deletes a deregistration\ntoken that a user has access to, thus cancelling\nthe request to de-register the user.\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user/deregistration/:uid","parameters":[{"Type":"String","Description":"The identifier of the token","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Delete a deregistration token","returnFormats":[{"key":"token","accept":"application/json","Name":"json"}]}],"name":"Deregistration Tokens","URI":"/service/user/deregistration"},{"identifier":"ws-user","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides information about the current user,\nincluding their user name and preferences.\n             ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user","parameters":[],"Synopsis":"Get information about the Current User","returnFormats":[{"key":"user","accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service deletes the current User and all their data.\n To ensure that you really mean to deregister a user\nprogrammatically, this service requires a deregistration\ntoken to be obtained before sending the delete request.\n As output it returns all of the user data it had before it was\ndeleted.\n             ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user","parameters":[{"Type":"String","Description":"A token to ensure this is not a mistake","Required":"Y","Recommended":false,"Name":"deregistrationToken"}],"Synopsis":"Delete the Current User","returnFormats":[{"accept":"application/xml","Name":"xml"}]},{"DescriptionFormat":"markdown","Description":"This service modify the password of the current user.\n             ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/user","parameters":[{"Type":"String","Description":"The current password associated with the account.","Required":"Y","Recommended":false,"Name":"oldPassword"},{"Type":"String","Description":"The new password to associate with the account.","Required":"Y","Recommended":false,"Name":"newPassword"}],"Synopsis":"Modify the password of the current User","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"User","URI":"/service/user"},{"identifier":"ws-perma-tokens","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"Tokens are issued so that users may provide access\nto their private data to third parties in a more secure manner.\nThis service lets users inspect the permanent tokens they have\nissued.\n No access is provide here to other tokens (24hrs, api, day), for\nsecurity and other reasons. Please look at the `Session` service\nfor issuing new temporary tokens.\n             ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user/tokens","parameters":[],"Synopsis":"Get List of Permanent Tokens","returnFormats":[{"key":"tokens","accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"Tokens are issued so that users may provide access\nto their private data to third parties in a more secure manner.\nThis service lets users create a new token they can provide\nto others.\n\nThe different token types are:\n\n`day`\n : A token that will be valid for up to 24 hrs.\n`once`\n : A token that can only be used for a single request.\n`api`\n : The main Read-Write API key of the user. Generating one of these replaces the currrent key.\n`perm`\n : A permanent Read-Only token that others can use.\n             ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/user/tokens","parameters":[{"Type":"enumerated","Description":"The type of token to issue","Required":"N","Recommended":false,"EnumeratedList":["day","once","api","perm"],"Default":"day","Name":"type"},{"Type":"String","Description":"An optional message to associate with a token","Required":"N","Recommended":false,"Name":"message"}],"Synopsis":"Create a New Token","returnFormats":[{"key":"token","accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"Delete all permanent tokens.\n Permanent tokens are issued so that users may provide access\nto their private data to third parties in a more secure manner.\nThis service lets users all the delete permanent tokens they have\nissued.\n             ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user/tokens","parameters":[],"Synopsis":"Delete all Tokens","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Tokens","URI":"/service/user/tokens"},{"identifier":"ws-perma-token","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"Retrieve information about a specific permanent token.\n Permanent tokens are issued so that users may provide access\nto their private data to third parties in a more secure manner.\nThis service lets users inspect a specific permanent tokens they have\nissued.\n             ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/user/tokens/:uid","parameters":[{"Type":"String","Description":"The identifier of one of your tokens","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Get Token Information","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"Delete a specific permanent token.\n Permanent tokens are issued so that users may provide access\nto their private data to third parties in a more secure manner.\nThis service lets users delete permanent tokens they have\nissued.\n             ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user/tokens/:uid","parameters":[{"Type":"String","Description":"The identifier of one of your tokens","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Delete a Token","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Permanent Token","URI":"/service/user/tokens"},{"identifier":"ws-branding","minVersion":16,"methods":[{"Description":"Retrieve branding information, so that elements may be\nvisually styled appropriately for their source.\n             ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/branding","parameters":[],"Synopsis":"Get Branding Information","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Branding","URI":"/service/branding"},{"identifier":"ws-saved-queries","minVersion":16,"methods":[{"Description":"This resource represents access to the set of saved-queries\naccessible to a user. Saved queries are just normal queries, but\npersisted with the user's account.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/user/queries","parameters":[{"Type":"String","Description":"An optional filter by name, allowing wildcards.","Required":"N","Recommended":false,"Name":"filter"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Get the Saved Queries You have Access to.","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]},{"Description":"This resource allows users to upload queries to be saved into their profile.\nQueries that the user uploads should all be valid, and ideally have names. If they\ndo not have names, names will be assigned to them.\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","bodyDescription":"The queries to upload. If using body content.","body":[{"contentType":"application/xml","example":"<query model=\"genomic\" view=\"Gene.symbol Gene.proteins.proteinDomains.name\">\n    <constraint path=\"Gene\" op=\"LOOKUP\" value=\"eve\"/>\n<\/query>\n             "},{"contentType":"none","example":""}],"URI":"/user/queries","parameters":[{"Type":"String","Description":"The queries to upload, if using form parameters.","Required":"N","Recommended":false,"Default":"","Name":"xml"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","xml","tab","csv"],"Default":"text","Name":"format"}],"Synopsis":"Upload New Queries to be Saved into a User's Profile","returnFormats":[{"accept":"text/plain","Name":"text"},{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"},{"accept":"text/tab-separated-values","Name":"tab"},{"accept":"text/comma-separated-values","Name":"csv"}]},{"Description":"This resource allows users to upload queries to be saved into their profile.\nQueries that the user uploads should all be valid, and ideally have names. If they\ndo not have names, names will be assigned to them. If queries with the same name\nalready exist, they will be over-written. This provides a mechanism for updating\nthe value of saved queries on a service.\n            ","HTTPMethod":"PUT","RequiresAuthentication":"true","bodyDescription":"The queries to upload. If using body content.","body":[{"contentType":"application/xml","example":"<query model=\"genomic\" view=\"Gene.symbol Gene.proteins.proteinDomains.name\">\n    <constraint path=\"Gene\" op=\"LOOKUP\" value=\"eve\"/>\n<\/query>\n             "},{"contentType":"none","example":""}],"URI":"/user/queries","parameters":[{"Type":"String","Description":"The queries to upload, if using form parameters.","Required":"N","Recommended":false,"Default":"","Name":"query"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["text","json","xml","tab","csv"],"Default":"text","Name":"format"}],"Synopsis":"Update Existing Queries in a User's Profile","returnFormats":[{"accept":"text/plain","Name":"text"},{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"},{"accept":"text/tab-separated-values","Name":"tab"},{"accept":"text/comma-separated-values","Name":"csv"}]},{"DescriptionFormat":"markdown","Description":"This resource exposes the ability to delete specific saved queries, identified\nby name.\n A user can only delete queries that they own, and must be executed\nwith `Read/Write` permission.\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user/queries","parameters":[{"Options":"/user/queries|queries","Type":"String","Description":"The name of the query to delete","Required":"Y","Recommended":false,"Default":"{title}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Delete a saved query by name","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]}],"name":"Saved Queries","URI":"/service/user/queries"},{"identifier":"ws-saved-query","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This resource exposes the ability to delete specific saved queries, identified\nby name.\n A user can only delete queries that they own, and must be executed\nwith `Read/Write` permission.\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/user/queries/:name","parameters":[{"Options":"/user/queries|queries","Type":"String","Description":"The name of the query to delete","Required":"Y","Recommended":false,"Default":"{title}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Delete a saved query by name","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]}],"name":"Saved Query","URI":"/service/user/queries"},{"identifier":"ws-saved-template","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This resource retrieves a representation of a named template, returning\n404 if the template cannot be found.\n If the request is authenticated, then the templates visible to that user (created by\nor shared with them) will be included along with publically accessible templates.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/templates/:name","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to fetch","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Retrieve a template by name","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]},{"DescriptionFormat":"markdown","Description":"This resource exposes the ability to delete specific templates, identified\nby name.\n A user can only delete templates that they own, and must be executed\nwith `Read/Write` permission.\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/templates/:name","parameters":[{"Options":"/templates|templates","Type":"String","Description":"The name of the template to delete","Required":"Y","Recommended":false,"Default":"{name}","Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml"],"Default":"json","Name":"format"}],"Synopsis":"Delete a template by name","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"application/xml","Name":"xml"}]}],"name":"Saved Template","URI":"/service/templates"},{"identifier":"ws-session","minVersion":16,"methods":[{"DescriptionFormat":"markdown","Description":"This service opens a new 24 session for users. If authenticated to\nan existing user, it has the same effect as requesting a new 24hr\ntoken. But for unauthenticated users, it allocates a new temporary\nprofile, and assigns a 24hr usage token.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/session","parameters":[],"Synopsis":"Open a new Web-Services Session","returnFormats":[{"key":"token","Name":"json"}]}],"name":"Sessions","URI":"/service/session"},{"identifier":"ws-data","minVersion":16,"methods":[{"Description":"This service allows simple access to queries against a\nsingle type. This is meant to allow for simple linking\nand resource-based access to InterMine data.\n              ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/data/:type","parameters":[{"Options":"/model|model.classes","Type":"String","Description":"The type of the object to find.","Required":"Y","Recommended":false,"Default":"{name}","Name":"type"},{"Type":"String[]","Description":"An optional filter over the objects","Required":"N","Recommended":false,"Repeat":"/model|model.classes.$type.attributes","Name":"?"}],"Synopsis":"Get Data about Objects of the Given Type","returnFormats":[{"key":"results","accept":"application/json","Name":"json"}]}],"name":"JBrowse Simple Data Service","URI":"/service/data"},{"identifier":"ws-jbrowse-config","minVersion":17,"methods":[{"DescriptionFormat":"markdown","Description":"This service serves a `trackList.json` file suitable for\nuse with JBrowse.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Track Listing","URI":"/jbrowse/config/:domain/trackList.json","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"}],"Synopsis":"Get the Configuration for the Track Listing","returnFormats":[{"accept":"application/json","Name":"json"}]},{"DescriptionFormat":"markdown","Description":"This service serves a `refSeqs.json` file suitable for\nuse with JBrowse.\n See [Writing JBrowse Compatible Web Services](http://gmod.org/wiki/JBrowse_Configuration_Guide#Writing_JBrowse-compatible_Web_Services)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Get Reference Sequence List","URI":"/jbrowse/config/:domain/seq/refSeqs.json","parameters":[{"Options":"/data/Organism|results","Type":"String","Description":"The domain we are operating in. This will generally refer to an                     organism taxon-id","Required":"Y","Recommended":false,"Default":"{taxonId}","Name":"domain"}],"Synopsis":"Get the Configuration for the Reference Sequences","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"JBrowse Configuration Files","URI":"/service/jbrowse/config"},{"identifier":"ws-complexes-export","minVersion":18,"methods":[{"DescriptionFormat":"markdown","Description":"This service provides the JSON needed for the Complex Viewer.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","MethodName":"Find Complexes by Identifier","URI":"/complexes/export","parameters":[{"Type":"String","Description":"The format to return","Required":"N","Recommended":false,"Default":"json","Name":"format"}],"Synopsis":"Lookup Complexes by Identifier","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Complex Interaction Lookup","URI":"/service/complexes/export"},{"identifier":"ws-web-properties","methods":[{"Description":"The InterMine user interface can be customised with a set of properties, e.g.\ndefault values for the list upload, default values for the region search etc.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/web-properties","parameters":[],"Synopsis":"Get a description of the data model","returnFormats":[{"Name":"json"}]}],"name":"Web properties","URI":"/service/web-properties"},{"identifier":"ws-system-template","methods":[{"DescriptionFormat":"markdown","Description":"Get a listing of the templates configured in an InterMine instance tagged with\nthe `im:converter` tag.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/templates/system","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["xml","json"],"Default":"xml","Name":"format"}],"Synopsis":"Get the list of system templates.","returnFormats":[{"Name":"xml"},{"key":"templates","Name":"json"}]}],"name":"Templates (System)","URI":"/service/templates/system"},{"identifier":"ws-template-tags","minVersion":7,"methods":[{"Description":"Fetch an up-to-date list of all tags associated with a template, or all templates.\n                ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/template/tags","parameters":[{"Type":"String","Description":"The name of a template whose tags to retrieve. If no template is provided, then all the tags associated with the authenticating user will be returned.","Required":"N","Recommended":false,"Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Get the tags for a template, or all the tags for a given user","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]},{"HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/template/tags","parameters":[{"Type":"String","Description":"The name of a template to add the tag(s) to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The name of the tags to add. It should take to from of a semi-colon delimited concatenation of the tag names.","Required":"Y","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Add one or more tags to a list","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]},{"HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/template/tags","parameters":[{"Type":"String","Description":"The name of a template to add the tag(s) to.","Required":"Y","Recommended":false,"Name":"name"},{"Type":"String","Description":"The name of the tags to remove. It should take to from of a semi-colon delimited concatenation of the tag names.","Required":"Y","Recommended":false,"Name":"tags"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","xml","tab","csv"],"Default":"json","Name":"format"}],"Synopsis":"Delete one or more tags from a list","returnFormats":[{"key":"tags","Name":"json"},{"Name":"xml"},{"Name":"tab"},{"Name":"csv"}]}],"name":"Template Tags","URI":"/service/template/tags"},{"identifier":"ws-bioentity-markup","minVersion":30,"methods":[{"Description":"This service provides semantic markup for Gene, Protein, DataSet types and BioChemEntity (if configured in the web.properties file)\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/semantic-markup/reportpage","parameters":[{"Type":"int","Description":"The internal InterMine id","Required":"Y","Recommended":false,"Name":"id"}],"Synopsis":"Get semantic markup for bioentity","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Semantic Markup","URI":"/service/semantic-markup/reportpage"},{"identifier":"ws-permanent-url","minVersion":30,"methods":[{"Description":"This service generates permanent URL based on the internal intermine ID. If the type=rdf, it returns the link to the rdf representation of the entity \n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/permanent-url","parameters":[{"Type":"String","Description":"The internal InterMine ID","Required":"Y","Recommended":false,"Name":"id"},{"Type":"String","Description":"The type of the url","Required":"N","Recommended":false,"Name":"type"}],"Synopsis":"Get permanent URL for data objetct","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Permanent URL","URI":"/service/permanent-url"},{"identifier":"ws-homepage-markup","minVersion":30,"methods":[{"Description":"This service provides semantic markup for the InterMine home page\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/semantic-markup/homepage","parameters":[],"Synopsis":"Get semantic markup for the home page","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Semantic Markup","URI":"/service/semantic-markup/homepage"},{"identifier":"ws-login","minVersion":31,"methods":[{"Description":"This service checks user's credential and attach anonymously created lists to\nthe user's account. A new session token is generated, to be used for further\nrequests\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/login","parameters":[{"Type":"String","Description":"The username","Required":"Y","Recommended":false,"Name":"user"},{"Type":"String","Description":"The user's password","Required":"Y","Recommended":false,"Name":"password"}],"Synopsis":"Login a user","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Login","URI":"/service/login"},{"identifier":"ws-logout","minVersion":31,"methods":[{"Description":"This service invalidates the session token assigned the user logging out\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/logout","parameters":[],"Synopsis":"Login a user","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Logout","URI":"/service/logout"},{"identifier":"ws-feedback","minVersion":32,"methods":[{"Description":"This service allows users to send feedback\n            ","HTTPMethod":"POST","RequiresAuthentication":"false","URI":"/feedback","parameters":[{"Type":"Email","Description":"The user email","Required":"N","Recommended":false,"Name":"email"},{"Type":"String","Description":"The feedback","Required":"Y","Recommended":false,"Name":"feedback"}],"Synopsis":"Send feedback","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Feedback","URI":"/service/feedback"},{"identifier":"ws-request-psw-reset","minVersion":32,"methods":[{"Description":"This service sends a password change email to the user email address\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/user/requestpswreset","parameters":[{"Type":"Email","Description":"The user email","Required":"N","Recommended":false,"Name":"email"},{"Type":"String","Description":"The url where the user is redicted to change the password","Required":"Y","Recommended":false,"Name":"redirectUrl"}],"Synopsis":"Send a password change email with token","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Request Password Reset","URI":"/service/user/requestpswreset"},{"identifier":"ws-psw-reset","minVersion":32,"methods":[{"Description":"This service changes a user's password with the authority of a token previously emailed\n            ","HTTPMethod":"PUT","RequiresAuthentication":"false","URI":"/user/pswreset","parameters":[{"Type":"String","Description":"The token previously emailed","Required":"Y","Recommended":false,"Name":"pswResetToken"},{"Type":"String","Description":"The new password","Required":"Y","Recommended":false,"Name":"newPassword"}],"Synopsis":"Reset a password","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Password Reset","URI":"/service/user/pswreset"},{"identifier":"ws-bg-properties","minVersion":32,"methods":[{"Description":"This service returns the value of key, or all key-values if not specified\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/bluegenes-properties","parameters":[{"Type":"String","Description":"The key","Required":"N","Recommended":false,"Name":"key"}],"Synopsis":"Get value of key, or all key-values if key is not specified","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service adds a new key with value\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/bluegenes-properties","parameters":[{"Type":"String","Description":"The key","Required":"Y","Recommended":false,"Name":"key"},{"Type":"String","Description":"The value","Required":"Y","Recommended":false,"Name":"value"}],"Synopsis":"Add new key with value","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service updates the value of existing key\n            ","HTTPMethod":"PUT","RequiresAuthentication":"true","bodyDescription":"The key and value, if using body content.","body":[{"contentType":"application/x-www-form-urlencoded","example":""}],"URI":"/bluegenes-properties","parameters":[{"Type":"String","Description":"The key","Required":"Y","Recommended":false,"Name":"key"},{"Type":"String","Description":"The new value","Required":"Y","Recommended":false,"Name":"value"}],"Synopsis":"Update value of existing key","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service removes existing key\n            ","HTTPMethod":"DELETE","RequiresAuthentication":"true","URI":"/bluegenes-properties","parameters":[{"Type":"String","Description":"The key","Required":"Y","Recommended":false,"Name":"key"}],"Synopsis":"Remove existing key","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"BlueGenes Properies","URI":"/service/bluegenes-properties"},{"identifier":"ws-list-resolver","minVersion":32,"methods":[{"DescriptionFormat":"markdown","Description":"List Resolution job checks that all the identifiers in the given list are still valid. Jobs are run asynchronously, so this service simply submits the\njob, and returns the identifier of the job, so that its results and status\nmay be polled later.\n          ","HTTPMethod":"POST","RequiresAuthentication":"true","MethodName":"Submit a List Upgrading Job","URI":"/listresolver","parameters":[{"Type":"String","Description":"The name of the list which will be checked by the job","Required":"Y","Recommended":false,"Name":"name"}],"Synopsis":"Start a new List Resolution Job on the Server","returnFormats":[{"key":"uid","Name":"json"}]},{"Description":"Get a representation of the status of job.","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Check Job Status","URI":"/listresolver/:uid/status","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Check the Status of a Given Job","returnFormats":[{"key":"status","accept":"application/json","Name":"json"}]},{"Description":"Get the full results of running a specific job.","HTTPMethod":"GET","RequiresAuthentication":"true","MethodName":"Retrieve Job Results","URI":"/listresolver/:uid/results","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Get the Results of a Given Job","returnFormats":[{"key":"results","accept":"application/json","Name":"json"}]},{"Description":"Each job should be removed from the server when the user has finished inspecting the results.","HTTPMethod":"DELETE","RequiresAuthentication":"true","MethodName":"Delete A Job","URI":"/listresolver/:uid","parameters":[{"Type":"String","Description":"The unique identifier of the job","Required":"Y","Recommended":false,"Name":"uid"}],"Synopsis":"Delete a given job from the server.","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"List Resolution","URI":"/service/listresolver"},{"identifier":"ws-upgrade-list","minVersion":32,"methods":[{"Description":"This service allows to upgrade an existing list in order to resolve any conflicts after a new build.\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","bodyDescription":"Internal IDS which will be used to upgrade the list, tab, comma or newline separated.","ALSO":"POST","body":[{"contentType":"text/plain","example":""}],"URI":"/upgradelist","parameters":[{"Type":"String","Description":"The name of the list which will be upgraded","Required":"Y","Recommended":false,"Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Upgrade a list with conflicts after a new build","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]},{"Description":"This service allows to upgrade an existing list in order to resolve any conflicts after a new build.\n            ","HTTPMethod":"POST","RequiresAuthentication":"false","bodyDescription":"Internal IDS which will be used to upgrade the list, tab, comma or newline separated.","ALSO":"POST","body":[{"contentType":"text/plain","example":""}],"URI":"/upgradelist","parameters":[{"Type":"String","Description":"The name of the list which will be upgraded","Required":"Y","Recommended":false,"Name":"name"},{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["json","text"],"Default":"json","Name":"format"}],"Synopsis":"Upgrade a list with conflicts after a new build","returnFormats":[{"accept":"application/json","Name":"json"},{"accept":"text/plain","Name":"text"}]}],"name":"Upgrade List","URI":"/service/upgradelist"},{"identifier":"ws-oauth2-authenticator","minVersion":32,"methods":[{"Description":"This service redirects the user to the oauth2 authenticator provider\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/oauth2authenticator","parameters":[{"Type":"String","Description":"The provider used for the authentication, e.g. GOOGLE, IM","Required":"Y","Recommended":false,"Name":"provider"}],"Synopsis":"OAuth2 Authenticator","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"OAuth2 Authenticator","URI":"/service/oauth2authenticator"},{"identifier":"ws-oauth2-callback","minVersion":32,"methods":[{"Description":"This service is called by the oauth2 authenticator provider after the user logs in\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/oauth2callback","parameters":[{"Type":"String","Description":"The provider used for the authentication, e.g. GOOGLE, IM","Required":"Y","Recommended":false,"Name":"provider"},{"Type":"String","Description":"The client uri where the user is redirected after authentication","Required":"Y","Recommended":false,"Name":"redirect_uri"}],"Synopsis":"OAuth2 Callback","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"OAuth2 Callback","URI":"/service/oauth2callback"},{"identifier":"ws-precompute-template","minVersion":33,"methods":[{"Description":"This service tells if a template has been already precomputed\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/template/precompute","parameters":[{"Type":"String","Description":"The name of the template","Required":"N","Recommended":false,"Name":"name"}],"Synopsis":"Template Precomputed or not","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service allow to precompute a template\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/template/precompute","parameters":[{"Type":"String","Description":"The name of the template","Required":"Y","Recommended":false,"Name":"name"}],"Synopsis":"Precompute a template","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Precompute","URI":"/service/template/precompute"},{"identifier":"ws-summarise-template","minVersion":33,"methods":[{"Description":"This service tells if a template has been already summarised\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/template/summarise","parameters":[{"Type":"String","Description":"The name of the template","Required":"N","Recommended":false,"Name":"name"}],"Synopsis":"Template summarised or not","returnFormats":[{"accept":"application/json","Name":"json"}]},{"Description":"This service allow to Summarise a template\n            ","HTTPMethod":"POST","RequiresAuthentication":"true","URI":"/template/summarise","parameters":[{"Type":"String","Description":"The name of the template","Required":"Y","Recommended":false,"Name":"name"}],"Synopsis":"Summarise a template","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Summarise","URI":"/service/template/summarise"},{"identifier":"ws-all-templates","minVersion":34,"methods":[{"Description":"Get a listing of all templates configured in an InterMine instance by any user. Only admin users can access it\n            ","HTTPMethod":"GET","RequiresAuthentication":"true","URI":"/alltemplates","parameters":[{"Type":"enumerated","Description":"Output format","Required":"N","EnumeratedList":["xml","json"],"Default":"xml","Name":"format"}],"Synopsis":"All templates created by users","returnFormats":[{"Name":"xml"},{"accept":"application/json","Name":"json"}]}],"name":"All templates","URI":"/service/alltemplates"},{"identifier":"ws-entity-representation","minVersion":35,"methods":[{"Description":"This service return the representation of a entity\n            ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"/entity-representation","parameters":[{"Type":"String","Description":"The Local Unique Identifier of the entity","Required":"Y","Recommended":false,"Name":"lui"},{"Type":"String","Description":"The type of the representation. Only RDF is supported","Required":"Y","Recommended":false,"Name":"format"}],"Synopsis":"Entity Representation","returnFormats":[{"accept":"application/rdf+xml","Name":"rdf+xml"}]}],"name":"Entity Representation","URI":"/service/entity-representation"},{"identifier":"ws-service-listing","methods":[{"DescriptionFormat":"markdown","Description":"This service returns a description of all the endpoints of the\nweb services provided by this application. It includes a listing\nof all the calls that can be made, along with information about\nrequest parameters and output formats. This information is used\nto provide the listings rendered by [iodocs](http://iodocs.intermine.org).\n        ","HTTPMethod":"GET","RequiresAuthentication":"false","URI":"","parameters":[],"Synopsis":"Get a description of the services offered by this data-warehouse.","returnFormats":[{"accept":"application/json","Name":"json"}]}],"name":"Service Listing","URI":"/service"}],"auth":[{"name":"API key - parameter","type":"token","mechanism":"parameter","key":"token"},{"prefix":"Token ","name":"API key - header","type":"token","mechanism":"header","key":"Authorization"},{"name":"Username and Password","type":"password","mechanism":"basic"}]}