This changelog notes changes to API endpoints that are documented and listed through Swagger. Changes to undocumented, internal CATMAID APIs are not included in this changelog.
-
POST
/{project_id}/neurons/rename
: Rename multiple neurons at the same time. -
GET|POST
/{project_id}/skeletons/summary
: Retrieve meta information like cable length or number of nodes for skeletons. -
GET
/accounts/anonymous-api-token
: Get the API token for the anonymous user. -
POST
/{project_id}/neurons/all-skeletons
: Map a list of neuron IDs to the skeleton IDs that model them. -
GET
/{project_id}/
: Get project details like the title and comment. -
POST
/{project_id}/
: Update the project title if the user has admin permissions in the project.
-
GET /{project_id}/transactions/
: Now accepts the optional parameters user_id and type to further constrain the result. Type is a transaction label string, e.g. 'skeletons.import'. -
POST /{project_id}/skeletons/import
: Now accepts the optional boolean parameter replace_annotations, which can be used to remove all existing annotations if an existing neuron/skeleton is replaced with force=true. -
POST /{project_id}/graphexport/json
: The returned graph export is now in networkx 2.x format, rather than in v1.x format like before. The main difference is that start and target nodes of an edge are now defined explicitly by ID rather than an index. -
POST /{project_id}/skeleton/connectivity_matrix
: The new parameters row_relations and col_relations allow callers now to specify the relations used to connect two skeletons for each side. They default to "presynaptic_to" and "postsynaptic_to".
None.
None.
POST /{project_ids}/skeletons/in-bounding-box
: Returns now also unlinked connectors by default. To only get linked connectors like before, pass inonly_linked = true
.
-
GET
/{project_id}/stats/cable-length
: Accepts now an optional 'name_pattern' argument that allows case insensitive pattern matching in the respective neuron name. If a '/' prefix is used, the pattern is interpreted as a regular expression. -
GET|POST
/{project_id}/skeletons/validity
: Obtain a list of valid or invalid skeletons in a set pf passed in skeleton IDs. -
GET|POST /{project_id}/skeletons/from-origin
: Looks up skeleton IDs based on a set ofsource_ids
, asource_url
and asource_project_id
.. -
GET|POST /{project_id}/skeletons/origin
: Gets origin information on a list ofskeleton_ids
. -
GET|POST /{project_id}/skeletons/import-info
: Gets information on which and how many nodes are imported in a set of skeletons. -
POST /{project_id}/annotations/query-targets
: Accepts now an optional boolean "with_timestamps" parameter, which is set to false by default. If set to true, the returned annotations will include their creation_time and edition_time. -
POST /{project_id}/annotations/query-targets
: Accepts now two additional sorting options: annotated_on, last_annotation_link_edit. The first one sorts by the date the matched annotations were added to the target. The second option sorts by when this link was edited last. -
GET|POST
/{project_id}/skeletons/completeness
: Obtain compleness information on a list of skeletons. -
POST /{project_id}/skeletons/{skeleton_id}/find-labels
: The new optional boleanonly_leaves
parameter (default false) can be used to return only tagged leaf nodes (including root).
-
All APIs: errors during a request are now indicated with a more useful HTTP status code than 200: errors related to the request, input data and the client will result in status 400, permission errors in status 403, unavailable resources in status 404 and internal server errors in status 500.
-
POST|GET /{project_id}/node/list
: Offers a new optional parameter "ordering", which can be used to order the result set of nodes. The values cable-asc and cable-desc are allowed. By default no ordering is applied. -
POST|GET /{project_id}/volumes/
: Information on area, volume and watertightness is now returned for each volume as well as information on whether these details have been computed (meta_computed). This meta data can be computed for each volume using the{project_id}/volumes/{volume_id}/update-meta-info
API. -
GET /{project_id}/volumes/{volum_id}/update-meta-info
: Try to compute area, volume and watertightness for a volume. Setsmeta_computed
to true. If this operation fails, all meta data fields are set to NULL/None. -
POST /{project_id}/annotations/query-targets
: Accepts now an optional boolean "name_exact" parameter, which is set to false by default. If set to true, the passed in name has to match exactly. This is faster than using a regular expression like '/^name$' for exact matches. -
POST /{project_id}/skeletons/import
: The new parameterssource_id
andsource_url
allow to associate a source data reference with the imported skeleton. The new list parameter "annotations" can have annotation names, which are added to the import skeleton. By default only the annotation "Import" is set. -
POST /{project_id}/skeleton/join
: The new parameterlose_sampler_handling
controls how to deal with samplers defined for the merged in skeleton. Possible values are 'delete-sampler' and 'keep-sampler', the latter being the default. If samplers should be kept, it is required that the sampler domains are defined on parts of the skeleton that don't need local rerooting. Otherwise an error is raised.
None.
None.
-
GET /{project_id}/nodes/nearest
: ReplacesPOST /{project_id}/node/nearest
. The parameters are the same, but the API allows now to look globally for the nearest node in the project, if no skeleton ID or neuron ID is provided. -
GET /{project_id}/nodes/most-recent
: ReplacesPOST /{project_id}/node/nearest
. A skeleton_id parameter can still be provided, but now also a user_id parameter is available to further constrain.
-
POST|GET /{project_id}/node/list
: Offers a new optional parameter "min_skeleton_length", which can be used to constrain the returned neurons to only those of at least this cable length. -
POST|GET /{project_id}/pointclouds/
: Offers a new optional parameter "order_by", which accepts the strings 'id' and 'name' to define in what order the list of pointclouds should be retuned (default: id). -
POST /{project_id}/landmarks/{landmark_id}/
: Offers a new optional parameter "group_ids", an array of integers, which allows to set the landmark group memberships of a specific landmark. The new boolean parameter "append_memberships" allows to only append new group IDs as memberships, without removing any. Otherwise the whole set of memberships is replaced. -
POST /{project_id}/skeletons/import
: The new parameterskeleton_id
makes it possible to request a particular skeleton ID during import, just like it is done for neurons usingneuron_id
. If a skeleton or neuron with this ID exists already, a new object is created and the existing one is not touched. If an error should be raised instead, set theauto_id
parameter tofalse
. If instead the passed in IDs should replace existing data, theforce
parameter can be set totrue
. Both options apply to both neurons and skeletons. -
POST /{project_id}/skeletons/connectivity/csv
: The new optional parameternames
makes it possible to pass in a mapping of skeleton IDs to names used in the CSV export as column and row headers. If this parameter is not provided, the plain skeleton IDs will be used as it was done before. If it is provided, it has to be a list of two-element lists, each of the form [, ], which provides the mapping. -
POST /{project_id}/skeletons/connectivity
: Thesource_skeleton_ids
parameter can now also be specified in regular form format (multiple arguments with the exact same name), rather than only the square braces style.
None.
-
POST /{project_id}/node/nearest
: Replaced withGET /{project_id}/nodes/nearest
(note the plural of nodes). -
POST /{project_id}/node/most-recent
: Replaced withGET /{project_id}/nodes/most-recent
.
-
POST /{project_id}/skeletons/cable-length
: The POST version of the already existing GET endpoint. It allows passing in more skeleton IDs for which to get the cable length. -
POST /{project_id}/skeletons/connectivity-counts
: Allows to get the number connector links per relation type for each passed in skeleton. Also accepts GET parameters. -
POST /{project_id}/skeletons/connectivity_matrix/csv
: Return a CSV file containing the connectivity matrix for the passed inrows
andcolumns
. -
POST /{project_id}/skeletons/sampler-count
: Return the number of samplers linked to each skeleton in the passed inskeleton_ids
list. -
GET /{project_id}/skeletons/{skeleton_id}/sampler-count
: Return the number of samplers linked to this skeleton. -
GET /{project_id}/labels/detail
: Returns a list of of label objects, each with a name field and an ID field. -
POST /{project_id}/volumes/import
: Import volumes as STL files. -
GET /{project_id}/volumes/{volume_id}/export.{extension}
: Export a particular volume. Currentl only exports AS STL are supported. -
GET /{projec_id}/stats/cable-length
: Get the top N largest skeletons. N can be specified using the 'n_skeletons' parameter. -
POST /{project_id}/volumes/skeleton-innervations
: Get a list of all volume/skeleton combinations that intersect. Skeletons are provided with a 'skeleton_ids' parameter. This can be constrained by volume annotation, cable length and node count. -
POST /{project_id}/volumes/
: Previously only the GET method would be supported. With the introduction of an optionalvolume_ids
parameter, POST can be used as well. This parameter can be used to constrain the returned set of volumes.
-
POST /{project_id}/skeletons/node-label
: The newlabel_names
parameter accepts a list of strings that an be used instead of or together with label IDs to get skeletons with nodes that have particular labels. -
GET /{project_id}/stacks/{stack_id}/info
: Now includes thecomment
field for each stack. -
GET /{project_id}/connectors/
: The partner data returned when thewith_partners
is set, includes now additionally the creator of the link and the creation and edition time (in epoch format). -
GET /user-list
: Accepts a new boolean parameterwith_passwords
to export encrypted passwords, which in turn can be imported into other CATMAID instances. This requires the requesting user to be a superuser. -
GET /{project_id}/skeleton/{skeleton_id}/swc
: A new optional parametersoma_markers
can be supplied. It is a list of 'tag:soma', 'radius:' and 'root'. These are conditions for when a node is marked as soma in the SWC export. The first matching condition in this order wins. -
GET /{project_id}/volumes/
: The return format changed. Instead of a list of volume objects an object with a 'columns' field and a 'data' field are returned. The data fields contains a list of lists, with each inner list being a volume. The entries are described by the 'columns' field. Along with the already returned fields, annotations are now retuned as well. -
GET /{project_id}/volumes/
: An optionalvolume_ids
parameter can now be used and the POST method is supported as well (to transfer larger volume ID lists). This parameter can be used to constrain the returned set of volumes. -
POST /{project_id}/skeletons/connectivity
: A new optional option 'link_types' allows to specify which connectivity types should be returned. By default 'incoming' and 'outgoing' is returned. Additionally, the following options are allowed: gapjunction, abutting, attachment, close_object. The return field names have also been adapted to these parameters and match them. Instead of 'gapjunctions' and 'attachments', the fields are now named 'gapjunction' and 'attachment'. -
GET /{project_id}/annotations/
: Supports now an optional boolean parameter namedsimple
, which returns only names and IDs and is therefore much faster.
None.
None.
-
POST /{project_ids}/connectors/links
: Accepts the same parameters as the GET variant, but allows for larger skeleton_ids list. -
POST /{project_ids}/skeletons/in-bounding-box
: Accepts the same parameters as the GET variant, but allows for larger skeleton_ids list. -
GET /{project_id}/volumes/entities
: Return a mapping of volume IDs to their respective class instance ID.
-
GET /{project_id}/skeletons/in-bounding-box
: Themin_nodes
andmin_cable
parameters can be used to further filter the result. Thesrc
parameter can be 'postgis2d' and 'postgis3d', with the former being the default spatial query type. Thevolume_id
parameter can optionally be used to return the skeletons in the bounding box of a specific volume, alternative to explicit bounding box. Optionally, theskeleton_ids
parameter can provide a list of skeletons to test for intersections. Without it, all skeletons in the project are considered. -
GET /{project_id}/skeletons/{skeleton_id}/review
: The user ID of each node is now returned as well. -
POST|GET /{project_id}/node/list
: Offers a new optional parameter "n_largest_skeletons_limit", which can be used to constrain the returned neurons to only those of the N largest skeletons in the result set. -
POST /{project_id}/skeleton/connectivity_matrix
: The new parameter 'with_locations' includes more data in the result set. Each connector and its contributions to the link count is returned as well. -
GET|POST /{project_id}/skeletons/compact-detail
: The new parameter 'format' can now be used to returned the skeleton data in different formats. Supported are 'msgpack' and 'json'. -
GET /{project_id}/skeletons/{skeleton_id}/compact-detail
: The new parameter 'format' can now be used to returned the skeleton data in different formats. Supported are 'msgpack' and 'json'. -
POST /{project_id}/treenodes/compact-detail
: Thetreenode_ids
parameter is now optional and two new parameters can be used instead:label_ids
andlabel_names
. They can be used to constrain the result set by their labels. This effectively allows querying treenodes and skeletons based on linked labels. -
GET /{project_id/samplers/{sampler_id}/domains/
: Returns now also end nodes for each domain.
None.
None.
-
POST /{project_id}/treenodes/compact-detail
: Retrieve treenode information for multiple nodes in the format of regular node queries, accepts a parameter "treenode_ids". -
GET /{project_id}/treenodes/{treenode_id}/compact-detail
: Retrieve treenode information for a single node. -
DELETE /{project_id}/landmarks/{landmark_id}/groups/{group_id}/
: Delete landmark location links to the same locations from a landmark and group. -
PUT /{project_id}/landmarks/groups/links/
: Add new links between groups, e.g. "adjacent_to". -
DELETE /{project_id}/landmarks/groups/links/{link_id}/
: Delete a single landmark group link. -
GET /{project_id}/landmarks/groups/{landmarkgroup_id}/transitively-linked
: Get a list of landmark groups that are linked to the referenced group using a passed in relation, respects reciprocal relations. -
POST /{project_id}/landmarks/groups/materialize
: Create pairs of landmark groups along with their landmarks based on a simple description. -
GET /{project_id}/skeletons/cable-length
: Get the cable length for multiple skeletons using the skeleton_ids parameter. -
GET /{project_id}/skeletons/{skeleton_id}/cable-length
: Get the cable length for a single skeleton. -
GET /{project_id}/skeletons/in-bounding-box
: Get IDs of all skeltons that intersect with the passed in bounding box.
-
POST /{project_id}/annotations/query-targets
: Accepts now a "annotation_reference" parameter which can either be 'id' (default) or 'name'. If it is set to 'name', all annotation references in annotated_with, not_annotated_with and sub_annotated_with are interpreted as annotation names instead of IDs. -
POST /{project_id}/skeleton/split
: Returns now also the split location as fields x, y and z. -
POST|GET /{project_id}/node/list
offers a new optional parameter "with_relation_map", which controls which relation map information is returned. Can be 'none', 'used' and all with 'used' being the default. -
GET /{project_id}/landmarks/groups/
: Accepts the new optional parameter "with_links", "with_names" and "with_relations", to include links between landmark groups along with a list of linked landmark names and a map of used relations -
GET /{project_id}/landmarks/groups/{group_id}/
: Accepts the new optional parameter "with_names" to include landmark names along with linked landmark locations. -
GET /{project_id}/stats/user-history
: Returns actual node count in "new_treenodes" field, cable length is returned in "new_cable_length" field (previously new_treenodes).
None.
None.
GET /{project_id}/useranalytics
: ReplacesGET /useranalytics
.
-
GET /{project_id}/samplers/
: Accepts now also a boolean with_intervals parameter to return information on each instantiated interval in each returned domain. Implies with_domains. -
POST|GET /{project_id}/node/list
offers a new optional parameter "src", which can be used to override the node provider selected by the back-end. -
POST|GET /{project_id}/node/list
offers new options for the optional parameter "format": "gif" and "png" to return an imageof the tracing data.
None.
GET /useranalytics
: Has been replaced withGET /{project_id}/useranalytics
.
-
POST /{project_id}/nodes/location
: Get the location of multiple nodes, expects anode_ids
parameter. -
GET /{project_id}/connectors/
now provides a new API to query connectors directly and not only links. The previous API is available asGET /{project_id}/connctors/links/
(see below). -
GET /{project_id}/skeletons/{skeleton_id}/neuroglancer
: Export a morphology-only skeleton in neuroglancer's binary format.
-
GET /{project_id}/connector/user-info
has been replaced withGET /{project_id}/connectors/user-info
. Functionality is the same. -
GET /{project_id}/connectors/
has been replaced withGET /{project_if}/connectors/links/
. Functionality is the same. -
POST /{project_id}/node/list
offers a new optional parameter "format", which is set by default to 'json', but can be set to 'msgpack' to use msgpack binary encoding of the result.
None.
None.
-
GET /{project_id}/samplers/domains/intervals/{interval_id}/details
: Get detailed information about a particular interval. -
GET /{project_id}/neurons/
: List all neurons in a project. Optionally, the parameters created_by, reviewed_by, from, to and nodecount_gt can be provided.
-
POST /{project_id}/treenodes/{treenode_id}/info
: This API endpoint is changed to only accept GET requests. Using POST will raise an error. -
GET /{project_id}/stats/nodecount
: The response format changed. Now a dictionary mapping user IDs to node counts is returned. -
GET /{project_id}/stats/editor
: The response format changed. Now a dictionary mapping user IDs to the number of edited nodes is returned. -
GET /{project_id}/projects/export
: Stacks include now also their translation and orientation relative to project space.
GET /{project_id}/annotationdiagram/nx_json
: This API has a confusing name, because it uses 'annotation' differently than others. There are different APIs available to get skeleton IDs and treenode IDs.
None.
None.
-
POST /{project_id}/skeletons/import
: The new 'name' parameter can be used to set the name of a new neuron. -
POST /{project_id}/annotations/query-target
: A boolean 'name_not' parameter is now accepted to get results not matching the name passed in with the regular 'name' parameter. Also, an integer list parameter named 'not_annotated_with' is now supported. Like the 'annotated_with' list, it contains annotation IDs. Results will not have the annotations passed in with thenot_annotated_with
list. -
GET /{project_id}/skeletons/{skeleton_id}/compact-detail
andGET /{project_id}/skeletons/compact-detail
Accepts two new parameters: with_reviews and with_annotations. To also return a list of reviews and a list of linked skeleton IDs respectively for each returned skeleton. -
POST /{project_id}/volumes/{volume_id}/
Individual fields can now be updated selectively. Only fields that are passed in as arguments will be updated. This allows for instance to only change the name of a volume.
None.
None.
None.
POST /{project_id}/skeletons/connectivity
: If the new "with_nodes" parameter is true, the involved treenode links are also returned for each partner.
None.
None.
None.
-
GET /messages/mark_read
: This API took a message ID as parameter before and is replaced by:POST /messages/{message_id}/mark_read
-
POST /{project_id}/node/user-info
: Thenode_id
parameter has been replaced with anode_ids
parameter, which is expected to be a list of node IDs. The response maps now individual info objects to their respective node IDs. -
GET /{project_id}/connectors/
Each result link now contains one additional column: the link's creation time. It replaces the edition_time in column nine. The edition time is now available in column ten.
None.
None.
None.
None.
None.
None.
None.
POST /{project_id}/node/list
andPOST /{project_id}/node/list
: The returned timestamps are now second based UTC epoch numbers instead of UTC strings.
None.
None.
- POST
/{project_id}/analytics/broken-section-nodes
: Get s list of all nodes that are currently located in a broken section of any stack linked to their project. Obtionally, specific skeletons can be checked.
POST /{project_id}/skeleton/analytics
Is renamed toPOST /{project_id}/analytics/skeletons
.
None.
GET /{project_id}/stack/{stack_id}/models
Meshes have been replaced with volumes.
-
GET /{project_id}/labels/stats
Get statistics on node label usage for the project. -
POST /{project_id}/skeletons/node-labels
Return mappings from node label IDs to IDs of skeletons which include a node with that label.
None.
None.
None.
-
GET /{project_id}/skeletons/{skeleton_id}/compact-detail
Provides same functionality asGET/POST /{project_id}/{skeleton_id}/[0|1]/[0|1]/compact-skeleton
, but uses explicit GET parameters. -
POST /{project_id}/nodes/
Provides the same data as the formerPOST /{project_id}/nodes/list
and takes the same parameters.
None.
-
GET/POST /{project_id}/{skeleton_id}/[0|1]/[0|1]/compact-skeleton
This endpoint will be replaced in the future with the newly introduced endpointGET /{project_id}/skeletons/{skeleton_id}/compact-detail
. -
POST /{project_id}/node/list
This endpoint will be replaced in the future with the newly introduced endpointPOST /{project_id}/nodes/
. It takes the same parameters.
None.
GET /{project_id}/connectors/
Replaces thePOST /{project_id}/connector/table/list
endpoint, but also changes the parameter names. Additionally, the "relation_type" parameter is now expected to contain the actual relation name instead of a numeric alias: The value "0" is replaced with "postsynaptic_to" and "1" is replaced with "presynaptic_to". See /apis documentation for details.
None.
GET/POST /{project_id}/[0|1]/[0|1]/compact-skeleton
The new parameter with_history allows to include historic data in th response. Will also include timestamps for regular nodes.
None.
POST /{project_id}/connector/table/list
This endpoint is replaced by theGET /{project_id}/connectors
endpoint, described above.
None.
None.
None.
None.
None.
None.
None.
GET /{project_id}/stats
This endpoint returned an HTML document displayed by CATMAIDs statistics widget.
None.
None.
None.
None.
-
GET projects/export
: Provides all available information on the structure and properties of projects and stacks. Supports application/json and application/yaml content types. A return YAML document matches the format supported by the importer. -
POST /{project_id}/connector/info
: This endpoint replaces the/{project_id}/connector/pre-post-infos
endpoint. Thepre
andpost
parameters are now optional. -
POST /{project_id}/neurons/from-models
: Get the IDs of all neurons modeled by a list of entities, e.g. skelton IDs. -
POST /{project_id}/skeletons/import
: Import a neuron modeled by a skeleton from an uploaded file. Currently only SWC representation is supported. -
GET /{project_id}}/transactions/
Get a list of transaction objects, ordered by time (latest first). A sub-range can be specified optionally. -
GET /{project_id}}/transactions/location
Get a location representing the change in a given transaction. Returns error if no location was found.
-
GET /projects/
: Does not include the catalogueable property of projects anymore. Use ontology queries to filter by the "driver_line" class for the same semantics. -
POST /{project_id}/annotations/forskeletons
: Parameterskeleton_ids
now correctly parses with and without explicit indices. -
POST /{project_id}/annotations/query
: Parameterobject_ids
now correctly parses with and without explicit indices. -
POST /{project_id}/annotations/query-targets
: Parametertypes
now correctly parses with and without explicit indices. -
GET /{project_id}/ontology/list
: Return format has been made simpler, contains still same information. -
GET /{project_id}/ontology/relations/list
: Return format has been made simpler, contains still same information. -
GET /{project_id}/ontology/classes/list
: Return format has been made simpler, contains still same information.
None.
POST /{project_id}/connector/pre-post-info
: This endpoint was renamed to/{project_id}/connector/info
endpoint.
None.
None.
None.
None.
No change.
-
GET /{project_id}/labels/[treenode|connector]/{label_id}/
: Returns a list of labels for a node. -
GET /{project_id}/connectors/{connector_id}/
: Returns information on a connector and its partners. -
POST /{project_id}/skeletons/within-spatial-distance
: Find skeletons within a given L-infinity distance of a treenode.
POST /{project_id}/skeletons/connectivity
:
-
Response object now includes
gapjunctions
andgapjunctions_reviewers
properties for gap junction connectors. -
Documentation has correct parameter name:
source_skeleton_ids
notsource
.
POST /{project_id}/label/[treenode|connector]/{label_id}/update
:
- Returns now also information about what labels were added, which were duplicates and which labels were deleted.
POST /{project_id}/label/[treenode|connector]/{label_id}/remove
:
- Returns now also information about which label label was eventually removed. If nothing went wrong the field deleted_link has the input label ID.
POST /{project_id}/annotations/remove
:
- The return field
deleted_annotations
is now calleddeleted_links
and continues to contain a list of class_instance_class_instance IDs that were removed. The newdeleted_annotations
field contains a mapping of removed annotation IDs to the IDs of the object they were removed from.
POST /{project_id}/connector/delete
:
- The response contains now detailed information about the removed connector, including its partners.
POST /{project_id}/node/list
:
-
Edition times of nodes and connectors-links are now returned, too. Therefore some array indices changed.
-
Link and connector types are now returned in a more general fashion. Instead of providing four different arrays for pre, post, gap-junction and other connectors (previously index 5, 6, 7, 8), each connector entry now contains one list with all links (index 5), each link is represented as [<treenode_id>, <relation_id>, <link_confidence>].
POST /{project_id}/treenode/delete
:
- A list of removed links is now returned as well. Each entry has the following format: [, , , ].
POST /{project_id}/treenodes/{treenode_id}/confidence
:
-
Edition times of nodes and connectors-links are now returned, too. Each location ID in the returned updated_partners object, is now mapped to an object with an "edition_time" and an "old_confidence" field.
-
An optional "partner_ids" parameter is now accepted. If the "to_connectors" parameter is set to true, the "partner_ids" parameter allows to update only the links to the provided connector IDs.
-
An optional "partner_confidences" parameter is now accepted. If the "partner_ids" parameter is used, the "partner_confidences" parameter allows to specify an individual confidence for each selected partner.
POST /{project_id}/skeleton/join
:
- IDs of the result skeleton and the deleted skeleton are now returned.
None.
-[POST|GET] /{project_id}/label-for-node/[treenode|connector]/{label_id}
:
Has been replaced with:
GET /{project_id}/labels/[treenode|connector]/{label_id}/
The CATMAID API now authorizes requests using an API token tied to your account instead of your username and password. To obtain this token, open the CATMAID client in your browser, hover your cursor over your name (next to the "Logout" link), and click "Get API token". As a security measure, you will be prompted to re-enter your password, then shown your token string.
To use the API token, set the HTTP X-Authorization
header on all of your
API requests to be 'Token', a space, and the token string, e.g.:
X-Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b
-
GET /projects/
: List projects visible to the requesting user. -
GET /client/datastores/
: List key-value store datastores used by the client. -
POST /client/datastores/
: Create a key-value store datastore for the client. -
DELETE /client/datastores/{name}
: Delete a key-value store datastore for the client. -
GET /client/datastores/{name}/
: List key-value data in a datastore for the client. -
PUT /client/datastores/{name}/
: Create or replace a key-value data entry for the client. -
POST /{project_id}/volumes/{volume_id}/
: Get detailed information on a spatial volume or set its properties.
GET /{project_id}/annotations/
:
- Params are now correctly documented as form rather than query params.
POST /{project_id}/annotations/
:
- Params are now correctly documented as form rather than query params.
POST /{project_id}/annotations/forskeletons
:
- Params are now correctly documented as form rather than query params.
POST /{project_id}/skeletons/connectivity
:
boolean_op
form param now expects string "AND" or "OR" rather than "logic-AND" or "logic-OR".
POST /{project_id}/volumes/add
:
- Params are now correctly documented as form rather than query params.
None.
None.