{"collection":{"info":{"_postman_id":"358bdd21-10e7-4825-b82e-1229cb1865b4","name":"Sirv REST API","description":"Go to variables and set your client id and secret values. Make sure to set your clientId and clientSecret as 'Current values'.  \nThe authentification token is going to get automatically generated with a pre-request script.  \nMore info:\n\n- [REST API Reference](https://apidocs.sirv.com)\n    \n- [Help Center](https://sirv.com/help/)\n    \n- [Contact Us](https://sirv.com/help/support/)","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","createdAt":"2020-11-18T10:11:15.000Z","updatedAt":"2025-02-10T17:04:07.000Z","lastUpdatedBy":"296061","uid":"296061-358bdd21-10e7-4825-b82e-1229cb1865b4"},"item":[{"name":"Account","item":[{"name":"Get account info","event":[{"listen":"prerequest","script":{"id":"2445f9d4-ced0-4d7f-b53b-a9a6849f2fe1","exec":[""],"type":"text/javascript"}}],"id":"2774f32d-3845-4bae-836f-fb39a9cb9009","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true,"accept-encoding":true,"connection":true,"user-agent":true}},"request":{"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{token}}","type":"string"}]},"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":{"raw":"https://api.sirv.com/v2/account","protocol":"https","host":["api","sirv","com"],"path":["v2","account"]},"description":"Use this API method to get information about the account, including its CDN URL; account name; additional domains; remote fetching status; date created and more.\r\n\r\n\r\nhttps://apidocs.sirv.com/#get-account-info"},"response":[],"createdAt":"2020-11-18T10:40:33.000Z","updatedAt":"2020-11-22T12:38:28.000Z","uid":"296061-2774f32d-3845-4bae-836f-fb39a9cb9009"},{"name":"Get API limits","id":"e7cffeae-891c-4a75-b023-5d1c9cb1be52","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/account/limits","protocol":"https","host":["api","sirv","com"],"path":["v2","account","limits"]},"description":"https://apidocs.sirv.com/#get-api-limits"},"response":[],"createdAt":"2020-11-18T11:46:51.000Z","updatedAt":"2020-11-20T14:02:28.000Z","uid":"296061-e7cffeae-891c-4a75-b023-5d1c9cb1be52"},{"name":"Get storage info","id":"24fb902c-0305-449e-a458-54bc1ca02f01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/account/storage","protocol":"https","host":["api","sirv","com"],"path":["v2","account","storage"]},"description":"https://apidocs.sirv.com/#get-storage-info"},"response":[],"createdAt":"2020-11-18T11:47:30.000Z","updatedAt":"2020-11-20T14:02:49.000Z","uid":"296061-24fb902c-0305-449e-a458-54bc1ca02f01"},{"name":"Get users","id":"81557f64-b067-45ee-91f4-408ddbcd236e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/account/users","protocol":"https","host":["api","sirv","com"],"path":["v2","account","users"]},"description":"Use this API method to get a list of all users of an account. It will return a list of user IDs and their roles. If you need a users email address, the user ID can be used to obtain it.\r\n\r\n\r\nhttps://apidocs.sirv.com/#get-users"},"response":[],"createdAt":"2020-11-18T11:48:12.000Z","updatedAt":"2020-11-20T14:03:03.000Z","uid":"296061-81557f64-b067-45ee-91f4-408ddbcd236e"},{"name":"Get billing info","id":"c8575569-2689-4c0a-8fc2-a82797509ab1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/billing/plan","protocol":"https","host":["api","sirv","com"],"path":["v2","billing","plan"]},"description":"Use this API method to get all the billing plan information of an account, including price, storage and transfer allowances.\r\n\r\nhttps://apidocs.sirv.com/#get-billing-info"},"response":[],"createdAt":"2020-11-18T11:48:33.000Z","updatedAt":"2020-11-20T14:03:14.000Z","uid":"296061-c8575569-2689-4c0a-8fc2-a82797509ab1"},{"name":"Update account info","id":"5b67fcc5-a2ee-4653-9c61-17e43bb59b9c","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n  \"fetching\": {\r\n    \"enabled\": false\r\n  }\r\n}"},"url":{"raw":"https://api.sirv.com/v2/account","protocol":"https","host":["api","sirv","com"],"path":["v2","account"]},"description":"Use this method to change the account options. You can enable or disable JS/CSS file minification. You can also enable/disable automatic fetching via HTTP or S3 from a remote location.\r\n\r\n\r\nhttps://apidocs.sirv.com/#update-account-info"},"response":[],"createdAt":"2020-11-20T11:57:55.000Z","updatedAt":"2020-11-20T14:06:54.000Z","uid":"296061-5b67fcc5-a2ee-4653-9c61-17e43bb59b9c"},{"name":"List or search account events","id":"4cc94b9d-092d-4ef4-8345-678bb3285f14","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"module\": \"fetching\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/account/events/search","protocol":"https","host":["api","sirv","com"],"path":["v2","account","events","search"]},"description":"https://apidocs.sirv.com/#list-or-search-account-events"},"response":[],"createdAt":"2020-11-20T13:59:45.000Z","updatedAt":"2020-11-20T14:01:03.000Z","uid":"296061-4cc94b9d-092d-4ef4-8345-678bb3285f14"},{"name":"Mark account event(s) as seen","id":"2d5f64cb-71e3-4cd0-8535-521e8b56351a","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"[\r\n  \"f1f5d68ef232e5d27d10f28bcef836efbb7cdeba\",\r\n  \"199cf48046964f8567fe49e22107c4c5d27271e7\"\r\n]"},"url":{"raw":"https://api.sirv.com/v2/account/events/seen","protocol":"https","host":["api","sirv","com"],"path":["v2","account","events","seen"]},"description":"Add seen flag for specified account event(s)\r\n\r\n\r\nhttps://apidocs.sirv.com/#mark-account-event-s-as-seen"},"response":[],"createdAt":"2020-11-20T14:01:03.000Z","updatedAt":"2020-11-20T14:01:53.000Z","uid":"296061-2d5f64cb-71e3-4cd0-8535-521e8b56351a"}],"id":"c966b256-dc55-4000-bcfa-7269c199e52c","event":[{"listen":"prerequest","script":{"id":"5c33bc9c-68ac-4037-b474-c129ad8c1703","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f8fbc481-31e0-4acd-b111-a74116d0f173","type":"text/javascript","exec":[""]}}],"createdAt":"2020-11-18T11:49:39.000Z","updatedAt":"2020-11-20T14:01:03.000Z","uid":"296061-c966b256-dc55-4000-bcfa-7269c199e52c"},{"name":"User","item":[{"name":"Get user info","id":"ca1cb4f0-5ea7-4aa1-8913-9492a53cf4fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/user?userId","protocol":"https","host":["api","sirv","com"],"path":["v2","user"],"query":[{"key":"userId","value":null,"description":"You can get the user ID from the Get users method"}]},"description":"Use this API method to get information about a user, including their name, email and S3 key.\r\n\r\n\r\nDon't forget to set the userId parameter\r\nhttps://apidocs.sirv.com/#get-user-info"},"response":[],"createdAt":"2020-11-20T12:01:53.000Z","updatedAt":"2020-11-22T12:55:19.000Z","uid":"296061-ca1cb4f0-5ea7-4aa1-8913-9492a53cf4fd"}],"id":"d5c3efe7-858e-4ab0-8ead-458fc5e2c62f","createdAt":"2020-11-20T12:01:32.000Z","updatedAt":"2020-11-20T12:01:53.000Z","uid":"296061-d5c3efe7-858e-4ab0-8ead-458fc5e2c62f"},{"name":"Statistics","item":[{"name":"Get transfer stats","id":"4a3fa00e-262b-48a9-987f-ef4be4662f0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/stats/http?from=2022-07-01T00%3A00%3A00.000&to=2023-01-05T00%3A00%3A00.000","protocol":"https","host":["api","sirv","com"],"path":["v2","stats","http"],"query":[{"key":"from","value":"2022-07-01T00%3A00%3A00.000"},{"key":"to","value":"2023-01-05T00%3A00%3A00.000"}]},"description":"https://apidocs.sirv.com/#get-transfer-stats"},"response":[],"createdAt":"2020-11-20T12:21:15.000Z","updatedAt":"2023-01-31T17:41:41.000Z","uid":"296061-4a3fa00e-262b-48a9-987f-ef4be4662f0d"},{"name":"Get spins views","id":"b4d7f847-3781-499b-8829-71672734a1cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/stats/spins/views?from=2022-12-01T00%3A00%3A00.000&to=2023-01-05T00%3A00%3A00.000","protocol":"https","host":["api","sirv","com"],"path":["v2","stats","spins","views"],"query":[{"key":"from","value":"2022-12-01T00%3A00%3A00.000"},{"key":"to","value":"2023-01-05T00%3A00%3A00.000"}]},"description":"https://apidocs.sirv.com/#get-spins-views"},"response":[],"createdAt":"2020-11-20T12:22:24.000Z","updatedAt":"2023-01-31T17:44:17.000Z","uid":"296061-b4d7f847-3781-499b-8829-71672734a1cf"},{"name":"Get storage stats","id":"abd07ab3-b825-47eb-a562-48f63b55fa81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/stats/storage?from=2022-07-01T00%3A00%3A00.000&to=2023-01-05T00%3A00%3A00.000","protocol":"https","host":["api","sirv","com"],"path":["v2","stats","storage"],"query":[{"key":"from","value":"2022-07-01T00%3A00%3A00.000","description":"From date"},{"key":"to","value":"2023-01-05T00%3A00%3A00.000","description":"To date"}]},"description":"https://apidocs.sirv.com/#get-storage-stats"},"response":[],"createdAt":"2020-11-20T12:23:00.000Z","updatedAt":"2023-01-31T17:41:13.000Z","uid":"296061-abd07ab3-b825-47eb-a562-48f63b55fa81"},{"name":"Get traffic data","id":"79caaab4-96cd-4247-93e8-6b16b80bf8e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/stats/http/agg/traffic","protocol":"https","host":["api","sirv","com"],"path":["v2","stats","http","agg","traffic"]}},"response":[],"createdAt":"2021-02-09T14:59:40.000Z","updatedAt":"2021-02-09T15:01:25.000Z","uid":"296061-79caaab4-96cd-4247-93e8-6b16b80bf8e8"}],"id":"1165bc5f-83dc-4634-8577-9cb9e9503e60","createdAt":"2020-11-20T12:20:52.000Z","updatedAt":"2021-02-09T14:59:41.000Z","uid":"296061-1165bc5f-83dc-4634-8577-9cb9e9503e60"},{"name":"Files","item":[{"name":"Multipart Uploads (tus.io)","item":[{"name":"Get tus.io locations","id":"51cdfb4c-420f-42ea-8af5-8e91976bafe6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/tus/locations","protocol":"https","host":["api","sirv","com"],"path":["v2","files","tus","locations"]}},"response":[],"createdAt":"2025-02-10T16:57:58.000Z","updatedAt":"2025-02-10T17:02:59.000Z","uid":"296061-51cdfb4c-420f-42ea-8af5-8e91976bafe6"},{"name":"Get upload URL","id":"a0f8653b-4ba0-4be5-acf1-122deea407e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/tus/url?location=us_washington","protocol":"https","host":["api","sirv","com"],"path":["v2","files","tus","url"],"query":[{"key":"location","value":"us_washington"}]}},"response":[],"createdAt":"2025-02-10T16:59:29.000Z","updatedAt":"2025-02-10T17:03:02.000Z","uid":"296061-a0f8653b-4ba0-4be5-acf1-122deea407e8"}],"id":"7acbd3dd-030f-46e1-900d-7640ffb09599","description":"Instead of the standard upload API, you can use the tus.io upload  \nAPI. tus.io uploads files by breaking them into smaller chunks, up to  \n1MB per chunk. This method of uploading has the following benefits over  \nstandard API uploads:\n\n- Multipart uploads\n    \n- Lower latency, faster upload (to nearest of 24 CDN locations)\n    \n- Higher hourly upload limit\n    \n- Large maximum file size of 1 GB\n    \n\nFull documentation -\n\n[https://sirv.com/help/articles/upload-files-with-the-api/#tus-io-multipart-uploads](https://sirv.com/help/articles/upload-files-with-the-api/#tus-io-multipart-uploads)","createdAt":"2025-02-10T17:00:37.000Z","updatedAt":"2025-02-10T17:02:08.000Z","uid":"296061-7acbd3dd-030f-46e1-900d-7640ffb09599"},{"name":"Get approval flag","id":"dac8a6bc-1b48-43eb-ba60-2fdacfe8db91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/meta/approval?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","approval"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to get the file approval tag and optional comment for a file. Used as part of an image review and approval process.\r\n\r\n\r\nIn this and other examples, make sure to change the parameter values to your own.\r\n\r\n\r\nhttps://apidocs.sirv.com/#get-approval-flag"},"response":[],"createdAt":"2020-11-19T11:23:15.000Z","updatedAt":"2020-11-20T13:58:56.000Z","uid":"296061-dac8a6bc-1b48-43eb-ba60-2fdacfe8db91"},{"name":"Get meta description","id":"c72b2b43-b88b-4ba2-a8a3-beb2040e1aa1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/meta/description?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","description"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to check the meta description of a file or folder. For images, this is the meta field that is used for showing alt tags on images.\r\n\r\nhttps://apidocs.sirv.com/#get-meta-description"},"response":[],"createdAt":"2020-11-19T11:19:51.000Z","updatedAt":"2020-11-20T13:52:47.000Z","uid":"296061-c72b2b43-b88b-4ba2-a8a3-beb2040e1aa1"},{"name":"Get product meta","id":"b4d3f6f9-28b6-4d02-9db3-6e24d1eee759","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/meta/product?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","product"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#get-product-meta"},"response":[],"createdAt":"2020-11-19T11:23:55.000Z","updatedAt":"2020-11-22T19:17:19.000Z","uid":"296061-b4d3f6f9-28b6-4d02-9db3-6e24d1eee759"},{"name":"Get file meta tags","id":"9c5f074f-65f6-4818-ad5c-0572c7a23aa5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/meta/tags?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","tags"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#get-file-meta-tags"},"response":[],"createdAt":"2020-11-19T11:26:29.000Z","updatedAt":"2020-11-20T13:52:29.000Z","uid":"296061-9c5f074f-65f6-4818-ad5c-0572c7a23aa5"},{"name":"Get meta title","id":"42b01afe-3bcb-42f7-9bc5-ce812b85dc97","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/meta/title?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","title"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#get-meta-title"},"response":[],"createdAt":"2020-11-20T12:32:53.000Z","updatedAt":"2020-11-20T13:52:07.000Z","uid":"296061-42b01afe-3bcb-42f7-9bc5-ce812b85dc97"},{"name":"Get folder options","id":"7174ebbe-a881-4d25-ba76-ee56c35359fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"https://api.sirv.com/v2/files/options?filename=/temp/&withInherited=true","protocol":"https","host":["api","sirv","com"],"path":["v2","files","options"],"query":[{"key":"filename","value":"/temp/"},{"key":"withInherited","value":"true","type":"text"}]},"description":"https://apidocs.sirv.com/#get-folder-options"},"response":[],"createdAt":"2020-11-20T12:33:44.000Z","updatedAt":"2020-11-21T19:20:48.000Z","uid":"296061-7174ebbe-a881-4d25-ba76-ee56c35359fe"},{"name":"Read folder contents","id":"b7174716-6225-445d-9d80-fd78f294c012","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/readdir?dirname=/&continuation","protocol":"https","host":["api","sirv","com"],"path":["v2","files","readdir"],"query":[{"key":"dirname","value":"/"},{"key":"continuation","value":null}]},"description":"Use this API method to check all the files within a folder. It will return the filename, mimetype, content type and file size. It will also return any folders that exist.\r\n\r\n\r\nhttps://apidocs.sirv.com/#read-folder-contents"},"response":[{"id":"2275acba-0d6f-47fd-9a1b-9d386a60916f","name":"Read folder contents","originalRequest":{"method":"GET","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/readdir?dirname=/temp/","protocol":"https","host":["api","sirv","com"],"path":["v2","files","readdir"],"query":[{"key":"dirname","value":"/temp/"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null,"createdAt":"2020-11-20T13:51:00.000Z","updatedAt":"2020-11-20T13:51:00.000Z","uid":"296061-2275acba-0d6f-47fd-9a1b-9d386a60916f"}],"createdAt":"2020-11-20T12:36:21.000Z","updatedAt":"2020-11-21T19:23:37.000Z","uid":"296061-b7174716-6225-445d-9d80-fd78f294c012"},{"name":"Get file info","id":"b367d352-2125-449f-b76f-020871ab7b14","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/stat?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","stat"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#get-file-info"},"response":[],"createdAt":"2020-11-20T12:38:01.000Z","updatedAt":"2020-11-20T13:50:31.000Z","uid":"296061-b367d352-2125-449f-b76f-020871ab7b14"},{"name":"Copy file","id":"eba5bc48-4814-46bf-b887-cea71dea7cad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/copy?from=/temp/test.png&to=/temp/test2.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","copy"],"query":[{"key":"from","value":"/temp/test.png"},{"key":"to","value":"/temp/test2.png"}]},"description":"https://apidocs.sirv.com/#copy-file"},"response":[],"createdAt":"2020-11-20T12:39:00.000Z","updatedAt":"2020-11-20T13:50:22.000Z","uid":"296061-eba5bc48-4814-46bf-b887-cea71dea7cad"},{"name":"Delete file or empty folder","id":"324904f1-6d2f-44f8-a6d2-400f53755aac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/delete?filename=/temp/test2.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","delete"],"query":[{"key":"filename","value":"/temp/test2.png"}]},"description":"https://apidocs.sirv.com/#delete-file-or-empty-directory"},"response":[],"createdAt":"2020-11-20T12:40:29.000Z","updatedAt":"2020-11-20T13:50:14.000Z","uid":"296061-324904f1-6d2f-44f8-a6d2-400f53755aac"},{"name":"Fetch URL","id":"b0314550-5183-4506-9ebf-64e1298e9854","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"[\r\n  {\r\n    \"url\": \"https://demo.sirv.com/aurora.jpg\",\r\n    \"filename\": \"/temp/aurora.jpg\"\r\n  },\r\n  {\r\n    \"url\": \"https://demo.sirv.com/missing.jpg\",\r\n    \"filename\": \"/temp/missing.jpg\"\r\n  }\r\n]","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.sirv.com/v2/files/fetch","protocol":"https","host":["api","sirv","com"],"path":["v2","files","fetch"],"query":[{"key":"filename","value":"/temp/test2.png","disabled":true},{"key":"url","type":"text","value":null,"disabled":true}]},"description":"Use this API method to fetch a file(s) from a URL via HTTP and save it to your Sirv account. This can be any URL, either public or private (via HTTP authentication). In the url parameter, enter the full URL of the remote file. In the filename parameter, enter the folder path and filename where it should be saved e.g. /path/to/folder/new-filename.jpg. If the folder path does not already exist in your Sirv account new folder(s) will be created.\r\n\r\nhttps://apidocs.sirv.com/#fetch-url"},"response":[],"createdAt":"2020-11-20T12:41:41.000Z","updatedAt":"2020-11-20T13:50:03.000Z","uid":"296061-b0314550-5183-4506-9ebf-64e1298e9854"},{"name":"Get JWT protected URL","event":[{"listen":"prerequest","script":{"id":"506cf9a1-9420-4f9c-8ea3-cd9b334e142c","exec":[""],"type":"text/javascript"}}],"id":"d327f628-2039-4d14-a9dc-b0ff57d9af83","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"content-type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"filename\": \"/Protected/test.png\",\r\n  \"key\": \"{{jwtKey}}\",\r\n  \"expiresIn\": 300000,\r\n    \"secureParams\": {\r\n    \"w\": 800,\r\n    \"h\": 800,\r\n    \"text\": \"These parameters will be hidden and applied\",\r\n    \"text.position\": \"center\"\r\n  }\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/jwt","protocol":"https","host":["api","sirv","com"],"path":["v2","files","jwt"],"query":[{"key":"filename","type":"text","value":null,"disabled":true}]},"description":"Use this API method to generate a secure file URL, protected with JWT (JSON Web Token).\r\n\r\n**Contact us at https://sirv.com/contact/ to get access to this method.**\r\n\r\nDon't forget to set your jwtKey and alias variables in the collections settings. \r\n\r\nYou can find the alias in your Sirv settings- https://my.sirv.com/#/account/settings and we'll email you your key after activating the JWT feature.\r\n\r\nhttps://apidocs.sirv.com/#get-jwt-protected-url\r\n\r\nhttps://sirv.com/help/json-web-token-protected-signed-url"},"response":[],"createdAt":"2020-11-18T19:30:20.000Z","updatedAt":"2020-11-24T15:44:43.000Z","uid":"296061-d327f628-2039-4d14-a9dc-b0ff57d9af83"},{"name":"Set approval flag","id":"160d8f84-5cee-4336-87f5-999dfb7008e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"approved\": true,\r\n  \"comment\": \"It's great\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/approval?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","approval"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to set the file approval tag (approved or not) and an optional comment. Used as part of an image review and approval process.\r\nhttps://apidocs.sirv.com/#set-approval-flag"},"response":[],"createdAt":"2020-11-20T12:47:38.000Z","updatedAt":"2020-11-20T13:49:08.000Z","uid":"296061-160d8f84-5cee-4336-87f5-999dfb7008e6"},{"name":"Set product meta","id":"eca7b2b1-375b-45e7-ae58-733f3f911472","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"id\": \"LLBB77\",\r\n  \"name\": \"Blue Lake Card\",\r\n  \"brand\": \"BLUE LAKE LLC\",\r\n  \"category1\": \"Cards\",\r\n  \"category2\": \"Lakes\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/product?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","product"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to set product meta fields for an image. This can be used by retailers for organizing images into product groups for an ecommerce store.\r\n\r\n\r\nhttps://apidocs.sirv.com/#set-product-meta"},"response":[],"createdAt":"2020-11-20T12:49:21.000Z","updatedAt":"2020-11-20T13:49:09.000Z","uid":"296061-eca7b2b1-375b-45e7-ae58-733f3f911472"},{"name":"Set meta description","id":"6a2e59e5-ddf2-4af9-9d13-e51522090bd4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"description\": \"Blue Lake in the Winter\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/description?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","description"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to set/change the meta description of a file or folder. For images, this is the meta field that is used for showing alt tags on images.\r\n\r\n\r\nhttps://apidocs.sirv.com/#set-meta-description"},"response":[],"createdAt":"2020-11-20T12:50:39.000Z","updatedAt":"2020-11-20T13:49:10.000Z","uid":"296061-6a2e59e5-ddf2-4af9-9d13-e51522090bd4"},{"name":"Add file meta tags","id":"732d5f8f-88eb-41a6-85c9-680601955e5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"tags\": [\r\n    \"blue\",\r\n    \"lake\",\r\n    \"winter\",\r\n    \"cold\",\r\n    \"water\"\r\n  ]\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/tags?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","tags"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#add-file-meta-tags"},"response":[],"createdAt":"2020-11-20T12:51:39.000Z","updatedAt":"2020-11-20T13:49:11.000Z","uid":"296061-732d5f8f-88eb-41a6-85c9-680601955e5a"},{"name":"Set meta title","id":"5d9e441f-2aaa-4c6d-9ceb-119965f98e0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"title\": \"Blue Lake\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/title?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","title"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"Use this API method to set the meta title of a file or folder.\r\n\r\nhttps://apidocs.sirv.com/#set-meta-title"},"response":[],"createdAt":"2020-11-20T12:52:37.000Z","updatedAt":"2020-11-20T13:47:57.000Z","uid":"296061-5d9e441f-2aaa-4c6d-9ceb-119965f98e0c"},{"name":"Set folder options","id":"bf13236f-3f64-4de2-8863-72ba9673519f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"scanSpins\": true,\r\n  \"allowListing\": false\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/options?filename=/temp/","protocol":"https","host":["api","sirv","com"],"path":["v2","files","options"],"query":[{"key":"filename","value":"/temp/"}]},"description":"Use this API method to change the folder options. You can enable/disable spin scanning, change the spin naming convention and enable/disable publicly viewable folder listings.\r\n\r\n\r\nhttps://apidocs.sirv.com/#set-folder-options"},"response":[],"createdAt":"2020-11-20T12:54:00.000Z","updatedAt":"2020-11-20T14:13:13.000Z","uid":"296061-bf13236f-3f64-4de2-8863-72ba9673519f"},{"name":"Search files","id":"062cb9e7-d5b5-4cb3-9a11-854257a8771f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"query\": \"text AND -dirname:\\\\/.Trash\",\r\n  \"sort\": {\r\n    \"filename.raw\": \"asc\"\r\n  },\r\n  \"from\": 0,\r\n  \"size\": 5\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/search?","protocol":"https","host":["api","sirv","com"],"path":["v2","files","search"],"query":[{"key":"","value":null}]},"description":"Use this API method to search for files with a certain name, location, extension, type, created/modified time or with some specific meta information.\r\nhttps://apidocs.sirv.com/#search-files"},"response":[],"createdAt":"2020-11-20T12:55:23.000Z","updatedAt":"2022-05-30T11:18:23.000Z","uid":"296061-062cb9e7-d5b5-4cb3-9a11-854257a8771f"},{"name":"Scroll through search results","id":"64f2d142-9d3a-4c0d-b265-1977d85221cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n    \"scrollId\": \"\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/search/scroll","protocol":"https","host":["api","sirv","com"],"path":["v2","files","search","scroll"]},"description":"Use this API method to scroll through search results.\r\n\r\nhttps://apidocs.sirv.com/#scroll-through-search-results"},"response":[],"createdAt":"2020-11-20T12:57:05.000Z","updatedAt":"2020-11-20T12:59:36.000Z","uid":"296061-64f2d142-9d3a-4c0d-b265-1977d85221cc"},{"name":"Convert spin to video","id":"88213c26-390e-453f-9a98-32d301a90be4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"filename\": \"/temp/coin.spin\",\r\n  \"options\": {\r\n    \"width\": 1920,\r\n    \"height\": 1080,\r\n    \"loops\": 3\r\n  }\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/spin2video","protocol":"https","host":["api","sirv","com"],"path":["v2","files","spin2video"]},"description":"Use this API method to convert a 360 spin into an MP4 video. You can specify the width/height of the video and the number of rotations. If it is a multi-row spin, you can also specify which row should be converted.\r\n\r\nhttps://apidocs.sirv.com/#convert-spin-to-video"},"response":[],"createdAt":"2020-11-20T12:59:49.000Z","updatedAt":"2020-11-20T13:01:04.000Z","uid":"296061-88213c26-390e-453f-9a98-32d301a90be4"},{"name":"Upload file","id":"343f8b4b-1cc5-4378-93f2-3bccf86922a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"image/png"}],"body":{"mode":"file","file":{"src":""}},"url":{"raw":"https://api.sirv.com/v2/files/upload?filename=/example-folder/filename-on-sirv.jpg","protocol":"https","host":["api","sirv","com"],"path":["v2","files","upload"],"query":[{"key":"filename","value":"/example-folder/filename-on-sirv.jpg"}]},"description":"https://apidocs.sirv.com/#upload-file\r\n\r\nDon't forget to set the correct content-type header for your filetype.\r\n\r\nThe body of the request should contain the binary file contents (just select binary and upload a file in the 'body' section)"},"response":[],"createdAt":"2020-11-20T13:35:45.000Z","updatedAt":"2021-09-15T14:43:19.000Z","uid":"296061-343f8b4b-1cc5-4378-93f2-3bccf86922a2"},{"name":"Create new empty directory","id":"41c6d0ef-d9ca-49b5-b6cd-419038a97277","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/mkdir?dirname=/temp2/","protocol":"https","host":["api","sirv","com"],"path":["v2","files","mkdir"],"query":[{"key":"dirname","value":"/temp2/"}]},"description":"https://apidocs.sirv.com/#create-new-empty-directory"},"response":[],"createdAt":"2020-11-20T13:38:54.000Z","updatedAt":"2020-11-20T13:42:28.000Z","uid":"296061-41c6d0ef-d9ca-49b5-b6cd-419038a97277"},{"name":"Rename file or directory","id":"1405fafa-5403-44b4-8040-50477fb27a61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"https://api.sirv.com/v2/files/rename?from=/temp2/&to=/temp3/","protocol":"https","host":["api","sirv","com"],"path":["v2","files","rename"],"query":[{"key":"from","value":"/temp2/"},{"key":"to","value":"/temp3/","type":"text"}]},"description":"https://apidocs.sirv.com/#rename-file-or-directory"},"response":[],"createdAt":"2020-11-20T13:42:39.000Z","updatedAt":"2020-11-20T13:43:23.000Z","uid":"296061-1405fafa-5403-44b4-8040-50477fb27a61"},{"name":"Convert video to spin","id":"92c91614-2c98-4d17-bea3-74f0716e845e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"filename\": \"/Spins/BT262WL/BT262WL.mp4\",\r\n  \"options\": {\r\n    \"frames\": 72\r\n  }\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/video2spin","protocol":"https","host":["api","sirv","com"],"path":["v2","files","video2spin"]},"description":"https://apidocs.sirv.com/#convert-video-to-spin"},"response":[],"createdAt":"2020-11-20T13:43:39.000Z","updatedAt":"2022-11-02T14:58:43.000Z","uid":"296061-92c91614-2c98-4d17-bea3-74f0716e845e"},{"name":"Export spin zip for Amazon","id":"426b0e2b-0e6c-4fc3-ae8d-69d48a925ac6","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"filename\": \"/bag/bag.spin\",\r\n  \"asin\": \"ASINYOYO\"\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/spin2amazon360","protocol":"https","host":["api","sirv","com"],"path":["v2","files","spin2amazon360"]},"description":"Filename = path to your spin\r\n\r\nASIN = your unique product ID on Amazon e.g. B07D5F2NLB"},"response":[],"createdAt":"2021-03-13T15:48:44.000Z","updatedAt":"2021-03-15T17:35:48.000Z","uid":"296061-426b0e2b-0e6c-4fc3-ae8d-69d48a925ac6"},{"name":"Delete file meta tags","id":"31d8f0ad-f7df-4edd-906e-dc69f1157db3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n  \"tags\": [\r\n    \"ocean\"\r\n  ]\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/meta/tags?filename=/temp/test.png","protocol":"https","host":["api","sirv","com"],"path":["v2","files","meta","tags"],"query":[{"key":"filename","value":"/temp/test.png"}]},"description":"https://apidocs.sirv.com/#delete-file-meta-tags"},"response":[],"createdAt":"2020-11-20T13:46:14.000Z","updatedAt":"2020-11-20T14:12:52.000Z","uid":"296061-31d8f0ad-f7df-4edd-906e-dc69f1157db3"},{"name":"ZIP files","id":"36832319-3274-4ff4-a4d7-123bb652ee8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n    \"filenames\": [\"/help-ukraine/protest.jpg\", \"/help-ukraine/refugees.jpg\"]\r\n}"},"url":{"raw":"https://api.sirv.com/v2/files/zip","protocol":"https","host":["api","sirv","com"],"path":["v2","files","zip"]}},"response":[],"createdAt":"2023-01-16T11:57:19.000Z","updatedAt":"2023-01-16T12:03:38.000Z","uid":"296061-36832319-3274-4ff4-a4d7-123bb652ee8e"},{"name":"Check ZIP job","id":"6b3f5bef-19be-40ee-96fc-7abee467a43e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/zip?id=YbCD54X2IiamMwA5nD2gS1fbUZrYbKB2","protocol":"https","host":["api","sirv","com"],"path":["v2","files","zip"],"query":[{"key":"id","value":"YbCD54X2IiamMwA5nD2gS1fbUZrYbKB2"}]}},"response":[],"createdAt":"2023-01-16T12:04:04.000Z","updatedAt":"2023-01-16T12:11:56.000Z","uid":"296061-6b3f5bef-19be-40ee-96fc-7abee467a43e"},{"name":"Batch delete files","id":"9a351b77-da13-4bdb-83c3-a5bb482a3ccf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"filenames\": [\"/TESTZIP\", \"/filename.jpg\", \"/OTHER/Folder\"]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.sirv.com/v2/files/batch/delete","protocol":"https","host":["api","sirv","com"],"path":["v2","files","batch","delete"]},"description":"Include file or folder names in the request body"},"response":[],"createdAt":"2024-10-18T08:44:47.000Z","updatedAt":"2024-10-18T08:56:02.000Z","uid":"296061-9a351b77-da13-4bdb-83c3-a5bb482a3ccf"},{"name":"Check file delete job","id":"2072ea9b-521b-4c71-902b-f174f42f481f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":{"raw":"https://api.sirv.com/v2/files/batch/delete?id=jobid","protocol":"https","host":["api","sirv","com"],"path":["v2","files","batch","delete"],"query":[{"key":"id","value":"jobid"}]},"description":"Get the job id from Batch delete files, then check the status of the delete job via this endpoint.\n\n! Change the id param to your job id\n\nThe job is completed if you receive a 100 response code"},"response":[],"createdAt":"2024-10-18T08:51:43.000Z","updatedAt":"2024-10-18T08:58:07.000Z","uid":"296061-2072ea9b-521b-4c71-902b-f174f42f481f"}],"id":"43866fef-7013-4e41-bcf4-c8c762637f46","createdAt":"2020-11-18T19:30:04.000Z","updatedAt":"2025-02-10T17:01:13.000Z","uid":"296061-43866fef-7013-4e41-bcf4-c8c762637f46"}],"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{token}}","type":"string"}]},"event":[{"listen":"prerequest","script":{"id":"c75b8be7-2667-4784-9312-6c0c13009c36","type":"text/javascript","exec":["var clientId = pm.collectionVariables.get(\"clientId\"); ","var clientSecret = pm.collectionVariables.get(\"clientSecret\"); ","const postRequest = {","  url: 'https://api.sirv.com/v2/token',","  method: 'POST',","  header: {","    'content-type': 'application/json'","  },","    body: {","    mode: 'raw',","    raw: JSON.stringify({ clientId: clientId, clientSecret: clientSecret})","  }","};","pm.sendRequest(postRequest, (error, response) => {","  console.log(error ? error : response.json());","  pm.collectionVariables.set(\"token\", response.json().token);","});",""]}},{"listen":"test","script":{"id":"a2c7d181-c5d1-455b-bf39-8351ecda6eef","type":"text/javascript","exec":[""]}}],"variable":[{"key":"alias","value":""},{"key":"clientId","value":""},{"key":"clientSecret","value":""},{"key":"jwtKey","value":""},{"key":"token","value":""}]}}