{ "opencollection": "1.0.0", "info": { "name": "MX Platform accounts taggings API", "version": "20111101" }, "request": { "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "items": [ { "info": { "name": "taggings", "type": "folder" }, "items": [ { "info": { "name": "List taggings", "type": "http" }, "http": { "method": "GET", "url": "https://int-api.mx.com/users/:user_guid/taggings", "params": [ { "name": "page", "value": "1", "type": "query", "description": "Results are paginated. Specify current page." }, { "name": "records_per_page", "value": "10", "type": "query", "description": "This specifies the number of records to be returned on each page. Defaults to `25`. The valid range is from `10` to `1000`. If the value exceeds `1000`, the default value of `25` will be used instead." }, { "name": "user_guid", "value": "USR-fa7537f3-48aa-a683-a02a-b18940482f54", "type": "path", "description": "The unique identifier for a `user`, beginning with the prefix `USR-`." } ] }, "docs": "Use this endpoint to retrieve a list of all the taggings associated with a specific user." }, { "info": { "name": "Create tagging", "type": "http" }, "http": { "method": "POST", "url": "https://int-api.mx.com/users/:user_guid/taggings", "params": [ { "name": "user_guid", "value": "USR-fa7537f3-48aa-a683-a02a-b18940482f54", "type": "path", "description": "The unique identifier for a `user`, beginning with the prefix `USR-`." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Use this endpoint to create a new association between a tag and a particular transaction, according to their unique GUIDs." }, { "info": { "name": "Read tagging", "type": "http" }, "http": { "method": "GET", "url": "https://int-api.mx.com/users/:user_guid/taggings/:tagging_guid", "params": [ { "name": "tagging_guid", "value": "TGN-007f5486-17e1-45fc-8b87-8f03984430fe", "type": "path", "description": "The unique id for a `tagging`." }, { "name": "user_guid", "value": "USR-fa7537f3-48aa-a683-a02a-b18940482f54", "type": "path", "description": "The unique identifier for a `user`, beginning with the prefix `USR-`." } ] }, "docs": "Use this endpoint to read the attributes of a `tagging` according to its unique GUID." }, { "info": { "name": "Update tagging", "type": "http" }, "http": { "method": "PUT", "url": "https://int-api.mx.com/users/:user_guid/taggings/:tagging_guid", "params": [ { "name": "tagging_guid", "value": "TGN-007f5486-17e1-45fc-8b87-8f03984430fe", "type": "path", "description": "The unique id for a `tagging`." }, { "name": "user_guid", "value": "USR-fa7537f3-48aa-a683-a02a-b18940482f54", "type": "path", "description": "The unique identifier for a `user`, beginning with the prefix `USR-`." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Use this endpoint to update a tagging." }, { "info": { "name": "Delete tagging", "type": "http" }, "http": { "method": "DELETE", "url": "https://int-api.mx.com/users/:user_guid/taggings/:tagging_guid", "params": [ { "name": "tagging_guid", "value": "TGN-007f5486-17e1-45fc-8b87-8f03984430fe", "type": "path", "description": "The unique id for a `tagging`." }, { "name": "user_guid", "value": "USR-fa7537f3-48aa-a683-a02a-b18940482f54", "type": "path", "description": "The unique identifier for a `user`, beginning with the prefix `USR-`." } ] }, "docs": "Use this endpoint to delete a tagging according to its unique GUID. If successful, the API will respond with an empty body and a status of 204 NO Content." } ] } ], "bundled": true }