{ "info": { "_postman_id": "9675afe3-4141-4381-b3a2-c59b137b92a5", "name": "Atlassian snippets/", "description": "Needs description.\n\nContact Support:\n Name: Bitbucket Support\n Email: support@bitbucket.org", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "lastUpdatedBy": "35240", "uid": "35240-9675afe3-4141-4381-b3a2-c59b137b92a5" }, "item": [ { "name": "snippets", "item": [ { "name": "{workspace}", "item": [ { "name": "{encoded_id}", "item": [ { "name": "comments", "item": [ { "name": "{comment_id}", "item": [ { "name": "Atlassian Delete A Comment On A Snippet", "id": "038e33f3-e283-456a-a86f-9dbe9bf64975", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "id": "ed0950e0-a6e4-454d-bc0e-e2fe057cbf10", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "7d25155e-d81c-420a-bf54-f7ee0ec48d00", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "8e961156-67c3-467b-b5e5-be6a967ff685", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Deletes a snippet comment.

Comments can only be removed by the comment author, snippet creator, or workspace admin." }, "response": [ { "id": "ec0d96b9-a70e-415b-a888-b43a738e7304", "name": "Indicates the comment was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-ec0d96b9-a70e-415b-a888-b43a738e7304" }, { "id": "f1b154ea-ea95-420c-b359-de6dcff506a5", "name": "If the authenticated user is not the author of the comment.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-f1b154ea-ea95-420c-b359-de6dcff506a5" }, { "id": "400af73a-d3db-4e8b-a8c4-5f1fc75fb614", "name": "If the comment or the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-400af73a-d3db-4e8b-a8c4-5f1fc75fb614" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-038e33f3-e283-456a-a86f-9dbe9bf64975" }, { "name": "Atlassian Get A Comment On A Snippet", "id": "431d7020-4dac-4534-a321-e45b9e97cf09", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "id": "c74bc750-6405-41f6-a44f-46730e79a8e2", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "e89ac578-d9d2-475e-88b9-7be28ab2fa1a", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "4c7655f4-8527-47e8-b9cd-fe3522bc0056", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Returns the specific snippet comment." }, "response": [ { "id": "3fe9646c-702d-4cd0-9bf6-d74f95b8462a", "name": "The specified comment.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-3fe9646c-702d-4cd0-9bf6-d74f95b8462a" }, { "id": "4eb5fe87-7a07-4204-9311-984a4e7a262a", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-4eb5fe87-7a07-4204-9311-984a4e7a262a" }, { "id": "69e126d4-55a1-4b4f-a3ab-e17c8208b658", "name": "If the comment or snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-69e126d4-55a1-4b4f-a3ab-e17c8208b658" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-431d7020-4dac-4534-a321-e45b9e97cf09" }, { "name": "Atlassian Update A Comment On A Snippet", "id": "d06bb868-20c7-4c58-9868-a92e9d556826", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "id": "04ed3eab-7b62-4d58-85a3-1da4f68ad12f", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "fde413a6-7870-41f5-b2d3-8451920fbc3b", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "5665fe4e-db50-46af-ad4e-9ea9aa955f2d", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Updates a comment.

The only required field in the body is `content.raw`.

Comments can only be updated by their author." }, "response": [ { "id": "e5852c4c-d2da-4df3-892d-665d7e03c8bd", "name": "The updated comment object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e5852c4c-d2da-4df3-892d-665d7e03c8bd" }, { "id": "bc1860f6-1ea0-479b-9b61-fa2d6190f6bd", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-bc1860f6-1ea0-479b-9b61-fa2d6190f6bd" }, { "id": "848b25bf-c3a6-459b-9049-fc32db85598a", "name": "If the comment or snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments/:comment_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments", ":comment_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "comment_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-848b25bf-c3a6-459b-9049-fc32db85598a" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-d06bb868-20c7-4c58-9868-a92e9d556826" } ], "id": "fc213a3a-46f3-4095-a498-15071bf103cb", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-fc213a3a-46f3-4095-a498-15071bf103cb" }, { "name": "Atlassian List Comments On A Snippet", "id": "862a6f84-c2cf-472d-ab00-7aa5055e8db1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "id": "68f1915d-8518-4887-98fb-470ccb05c672", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "6fedd9d9-095d-405c-831b-50b2a8178419", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to retrieve a paginated list of all comments for a specific
snippet.

This resource works identical to commit and pull request comments.

The default sorting is oldest to newest and can be overridden with
the `sort` query parameter." }, "response": [ { "id": "027f8c68-c929-4f4a-8fae-35ae88a1ea38", "name": "A paginated list of snippet comments, ordered by creation date.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"size\": \"\",\n \"page\": \"\",\n \"pagelen\": \"\",\n \"next\": \"\",\n \"previous\": \"\",\n \"values\": [\n {\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n },\n \"id_ab\": 15114376\n },\n {\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"do_6e8\": true\n }\n }\n ]\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-027f8c68-c929-4f4a-8fae-35ae88a1ea38" }, { "id": "c73e6b1c-2ec5-4d7e-8767-9b5ecea7ec5d", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-c73e6b1c-2ec5-4d7e-8767-9b5ecea7ec5d" }, { "id": "0e56143b-2a32-4a72-9a69-2c111429c91d", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0e56143b-2a32-4a72-9a69-2c111429c91d" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-862a6f84-c2cf-472d-ab00-7aa5055e8db1" }, { "name": "Atlassian Create A Comment On A Snippet", "id": "0d008d44-4322-489b-bc63-493ec540e49c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "id": "2f735c41-5fd8-4ea6-bb4d-1e03e524df96", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "bc798a87-274c-4e47-bd10-d50b3823f4bd", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Creates a new comment.

The only required field in the body is `content.raw`.

To create a threaded reply to an existing comment, include `parent.id`." }, "response": [ { "id": "8ec00e64-285f-476b-af8e-ade4ffd47f93", "name": "The newly created comment.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "The URL of the new comment", "type": "text/plain" }, "key": "Location", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-8ec00e64-285f-476b-af8e-ade4ffd47f93" }, { "id": "713071f2-5612-4baa-a91e-2018102d35b3", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-713071f2-5612-4baa-a91e-2018102d35b3" }, { "id": "0fbb78d6-9c7a-4ade-a34f-27520977fc9d", "name": "If the snippet does not exist.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\",\n \"eiusmod_7ca\": -65257080.88690343\n },\n \"officia_4ff\": 31706766,\n \"veniamf1\": 43023219.51242286\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/comments", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "comments" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0fbb78d6-9c7a-4ade-a34f-27520977fc9d" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0d008d44-4322-489b-bc63-493ec540e49c" } ], "id": "ca96d742-d5b4-415c-b0e8-8c5405a548e7", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-ca96d742-d5b4-415c-b0e8-8c5405a548e7" }, { "name": "commits", "item": [ { "name": "{revision}", "item": [ { "name": "Atlassian Get A Previous Snippet Change", "id": "1debc0f6-473e-459b-aeee-674925e037a8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits/:revision", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits", ":revision" ], "variable": [ { "id": "6fb61d9c-5a11-4d48-8744-f48db7359b6f", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "d4d99ca3-1ded-44b7-b220-f75fb1a3e581", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "c9e1aefd-2ff3-4af8-ab26-85c4d9b53cc2", "key": "revision", "value": "", "description": "(Required) The commit's SHA1." } ] }, "description": "Returns the changes made on this snippet in this commit." }, "response": [ { "id": "502db13c-ff8f-4280-8f10-86276528e165", "name": "The specified snippet commit.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits/:revision", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits", ":revision" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"diff\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n },\n \"nostrud_5\": 38292977.451518,\n \"enim_e3a\": -1690148,\n \"eiusmod_25\": false\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-502db13c-ff8f-4280-8f10-86276528e165" }, { "id": "8867f09c-76b6-40ed-ae2a-791c619b2525", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits/:revision", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits", ":revision" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-8867f09c-76b6-40ed-ae2a-791c619b2525" }, { "id": "3432a6ad-b75a-4303-a60c-db55f495d2c5", "name": "If the commit or the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits/:revision", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits", ":revision" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-3432a6ad-b75a-4303-a60c-db55f495d2c5" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-1debc0f6-473e-459b-aeee-674925e037a8" } ], "id": "1c4d6289-462b-4f4f-9580-edd1da814da1", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-1c4d6289-462b-4f4f-9580-edd1da814da1" }, { "name": "Atlassian List Snippet Changes", "id": "73d49a89-c4bc-4a45-9f25-338b06a4269d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits" ], "variable": [ { "id": "05767a15-4f58-4062-a082-b4d98909202e", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "da05607e-54d2-421a-a0e4-90ac6bf17f52", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Returns the changes (commits) made on this snippet." }, "response": [ { "id": "db8281b1-b7dd-4fb6-bf58-10c935546c7d", "name": "The paginated list of snippet commits.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"size\": \"\",\n \"page\": \"\",\n \"pagelen\": \"\",\n \"next\": \"\",\n \"previous\": \"\",\n \"values\": [\n {\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"diff\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n }\n },\n {\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"diff\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-db8281b1-b7dd-4fb6-bf58-10c935546c7d" }, { "id": "764f2932-1685-48a9-b91b-3e8f26279fe7", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-764f2932-1685-48a9-b91b-3e8f26279fe7" }, { "id": "2b59dd2a-1661-431a-a108-c3cf6ca5fc27", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/commits", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "commits" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-2b59dd2a-1661-431a-a108-c3cf6ca5fc27" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-73d49a89-c4bc-4a45-9f25-338b06a4269d" } ], "id": "e9153e18-e371-4a87-ae6e-c09f760a2d9e", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e9153e18-e371-4a87-ae6e-c09f760a2d9e" }, { "name": "files", "item": [ { "name": "{path}", "item": [ { "name": "Atlassian Get A Snippet S Raw File At Head", "id": "2cd23228-a9f3-4ac2-bbc5-6e55b8db735e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "files", ":path" ], "variable": [ { "id": "fb7080b8-48f3-4275-9c14-d2efe504d41a", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "ecf95356-e7df-459a-8957-b7607e276c66", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "2fd3632b-60e9-4e23-85a9-f6b771a06c3b", "key": "path", "value": "", "description": "(Required) Path to the file." } ] }, "description": "Convenience resource for getting to a snippet's raw files without the
need for first having to retrieve the snippet itself and having to pull
out the versioned file links." }, "response": [ { "id": "134c4146-590b-4356-96f8-e8891ea55209", "name": "A redirect to the most recent revision of the specified file.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "path" } ] } }, "status": "Found", "code": 302, "_postman_previewlanguage": "text", "header": [ { "disabled": false, "description": { "content": "The URL of the most recent file revision.", "type": "text/plain" }, "key": "Location", "value": "" } ], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-134c4146-590b-4356-96f8-e8891ea55209" }, { "id": "a01fea10-21a1-4359-8ae8-bcce97b6f00a", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "path" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a01fea10-21a1-4359-8ae8-bcce97b6f00a" }, { "id": "247fc693-6d8d-404c-be5e-83d880229382", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "path" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-247fc693-6d8d-404c-be5e-83d880229382" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-2cd23228-a9f3-4ac2-bbc5-6e55b8db735e" } ], "id": "5668ac4d-c799-4d2f-9673-493f0fc69988", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-5668ac4d-c799-4d2f-9673-493f0fc69988" } ], "id": "0b820dda-0c5a-470d-95e3-cfe3103ef8df", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0b820dda-0c5a-470d-95e3-cfe3103ef8df" }, { "name": "watch", "item": [ { "name": "Atlassian Stop Watching A Snippet", "id": "c531dc34-426d-4f53-aab4-234785a71009", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "id": "f9708dc8-e4e0-4be8-934a-8393e81470ee", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "82ef7c6e-dc25-4813-85ec-f9bd4d55f2e3", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to stop watching a specific snippet. Returns 204 (No Content)
to indicate success." }, "response": [ { "id": "771ffb16-2bbb-4c73-b984-852c6fea9d77", "name": "Indicates the user stopped watching the snippet successfully.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-771ffb16-2bbb-4c73-b984-852c6fea9d77" }, { "id": "b4ddcad4-b6ec-4dc6-a4ba-52fd5d0c7476", "name": "If the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-b4ddcad4-b6ec-4dc6-a4ba-52fd5d0c7476" }, { "id": "e02eefa9-28f3-4450-8c2c-4a5617ff2c21", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e02eefa9-28f3-4450-8c2c-4a5617ff2c21" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-c531dc34-426d-4f53-aab4-234785a71009" }, { "name": "Atlassian Check If The Current User Is Watching A Snippet", "id": "3b5486d9-ff58-47a6-862a-003fc6cdcf88", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "id": "ec6914d0-3a3d-4133-9aa8-a1d85c55f2f4", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "90fa0e88-b6bc-41e4-8449-2fc949b6bb00", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to check if the current user is watching a specific snippet.

Returns 204 (No Content) if the user is watching the snippet and 404 if
not.

Hitting this endpoint anonymously always returns a 404." }, "response": [ { "id": "0c6823e9-2b20-4f90-a401-19a8f5f760eb", "name": "If the authenticated user is watching the snippet.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0c6823e9-2b20-4f90-a401-19a8f5f760eb" }, { "id": "a4d9acb7-57a7-44a7-952c-4780a2b18a12", "name": "If the snippet does not exist, or if the authenticated user is not watching the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a4d9acb7-57a7-44a7-952c-4780a2b18a12" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-3b5486d9-ff58-47a6-862a-003fc6cdcf88" }, { "name": "Atlassian Watch A Snippet", "id": "d6b208b0-0d7a-4183-aa36-e4089f863de6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "id": "d64c6787-7855-4535-b2c6-d9a1154f9048", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "c9b00bca-d445-4c04-be07-0ea73504c2d2", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to start watching a specific snippet. Returns 204 (No Content)." }, "response": [ { "id": "75c3a797-ae5e-4575-8be8-5b2f89c3fcae", "name": "Indicates the authenticated user is now watching the snippet.", "originalRequest": { "method": "PUT", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-75c3a797-ae5e-4575-8be8-5b2f89c3fcae" }, { "id": "5eee0880-3732-4107-8d0f-8201ae0543d5", "name": "If the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-5eee0880-3732-4107-8d0f-8201ae0543d5" }, { "id": "d293094b-3836-47e8-aa8f-9a67475e23c9", "name": "If the snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-d293094b-3836-47e8-aa8f-9a67475e23c9" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-d6b208b0-0d7a-4183-aa36-e4089f863de6" } ], "id": "020c4c00-eaca-4f4c-8537-ba1491ef5fbe", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-020c4c00-eaca-4f4c-8537-ba1491ef5fbe" }, { "name": "watchers", "item": [ { "name": "Atlassian List Users Watching A Snippet", "id": "e5674148-01aa-4e51-80ee-3e81f227ab7b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watchers", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watchers" ], "variable": [ { "id": "acced0be-6d7e-42b1-8a9f-706cd0e1d116", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "9577c1b1-a561-4062-8d79-452be17b0dbf", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Returns a paginated list of all users watching a specific snippet." }, "response": [ { "id": "bb2688ce-16de-4bcf-983e-c3e7eec6fa8b", "name": "The paginated list of users watching this snippet", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watchers", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watchers" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"size\": \"\",\n \"page\": \"\",\n \"pagelen\": \"\",\n \"next\": \"\",\n \"previous\": \"\",\n \"values\": [\n {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n }\n ]\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-bb2688ce-16de-4bcf-983e-c3e7eec6fa8b" }, { "id": "e7f3cfb9-c659-4963-8714-cb64d70e2188", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/watchers", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", "watchers" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e7f3cfb9-c659-4963-8714-cb64d70e2188" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e5674148-01aa-4e51-80ee-3e81f227ab7b" } ], "id": "2d21255a-d174-4542-961c-bb2a52c89e1b", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-2d21255a-d174-4542-961c-bb2a52c89e1b" }, { "name": "{node_id}", "item": [ { "name": "files", "item": [ { "name": "{path}", "item": [ { "name": "Atlassian Get A Snippet S Raw File", "id": "9908e6fe-f7e3-4bd1-8f42-e9e5ede3142a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id", "files", ":path" ], "variable": [ { "id": "f3681e66-dcf9-4d04-9e90-fe434d513e5c", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "da11e468-61bf-4160-a2ff-7e1f2970bcbd", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "35197323-54dd-4012-842b-5cbed64b3c3f", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." }, { "id": "a4d2c049-7148-47bf-84af-c1fa547e48fb", "key": "path", "value": "", "description": "(Required) Path to the file." } ] }, "description": "Retrieves the raw contents of a specific file in the snippet. The
`Content-Disposition` header will be \"attachment\" to avoid issues with
malevolent executable files.

The file's mime type is derived from its filename and returned in the
`Content-Type` header.

Note that for text files, no character encoding is included as part of
the content type." }, "response": [ { "id": "6c23a377-3703-464f-8d08-d20489f7701f", "name": "Returns the contents of the specified file.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" }, { "key": "path" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "disabled": false, "description": { "content": "The mime type as derived from the filename", "type": "text/plain" }, "key": "Content-Type", "value": "" }, { "disabled": false, "description": { "content": "attachment", "type": "text/plain" }, "key": "Content-Disposition", "value": "" } ], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-6c23a377-3703-464f-8d08-d20489f7701f" }, { "id": "c492f5a7-391d-41e5-8e40-3294551cb565", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" }, { "key": "path" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-c492f5a7-391d-41e5-8e40-3294551cb565" }, { "id": "b14111b7-a15e-40e2-bbbb-248784f91b48", "name": "If the file or snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id/files/:path", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id", "files", ":path" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" }, { "key": "path" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-b14111b7-a15e-40e2-bbbb-248784f91b48" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-9908e6fe-f7e3-4bd1-8f42-e9e5ede3142a" } ], "id": "f69eb44e-32c5-4362-ab4f-9822f3b6fd94", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-f69eb44e-32c5-4362-ab4f-9822f3b6fd94" } ], "id": "cda8467c-86a9-431a-8427-8e6b276580aa", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-cda8467c-86a9-431a-8427-8e6b276580aa" }, { "name": "Atlassian Delete A Previous Revision Of A Snippet", "id": "06bb7154-5653-4a7e-9179-cb238a937c17", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "id": "1f45541d-a4ef-416d-a5e5-5ece91f0eba1", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "68de0b70-6cd4-4f90-8f98-1df886fa29ac", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "0bfee553-3bc0-478f-b837-5f9ce4b2643f", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Deletes the snippet.

Note that this only works for versioned URLs that point to the latest
commit of the snippet. Pointing to an older commit results in a 405
status code.

To delete a snippet, regardless of whether or not concurrent changes
are being made to it, use `DELETE /snippets/{encoded_id}` instead." }, "response": [ { "id": "56b4c8da-3777-46a6-baff-6f3b86878eee", "name": "If the snippet was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-56b4c8da-3777-46a6-baff-6f3b86878eee" }, { "id": "4221973d-4378-44e1-aa3d-95d9b32adea9", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-4221973d-4378-44e1-aa3d-95d9b32adea9" }, { "id": "b2d76a0a-e785-4f01-9f5d-83e71546e61b", "name": "If authenticated user does not have permission to delete the private snippet.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-b2d76a0a-e785-4f01-9f5d-83e71546e61b" }, { "id": "d189cd4b-b7ae-4068-a2c9-30e45a49fa1d", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-d189cd4b-b7ae-4068-a2c9-30e45a49fa1d" }, { "id": "3a329b89-96aa-4d4e-b38f-d8edf3f4f720", "name": "If `{node_id}` is not the latest revision.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-3a329b89-96aa-4d4e-b38f-d8edf3f4f720" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-06bb7154-5653-4a7e-9179-cb238a937c17" }, { "name": "Atlassian Get A Previous Revision Of A Snippet", "id": "84f5ba79-f34a-4577-a0a8-8de13adb7d8c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "id": "88aee39f-82f6-4766-a7ad-0ef6bebf095c", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "330a3051-7bef-4ba4-bdfc-766441d65982", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "abdb3063-3f0d-4445-a8f7-d43a28eb293d", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Identical to `GET /snippets/encoded_id`, except that this endpoint
can be used to retrieve the contents of the snippet as it was at an
older revision, while `/snippets/encoded_id` always returns the
snippet's current revision.

Note that only the snippet's file contents are versioned, not its
meta data properties like the title.

Other than that, the two endpoints are identical in behavior." }, "response": [ { "id": "57a6d0ee-88b3-4851-8011-1af028204666", "name": "The snippet object.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-57a6d0ee-88b3-4851-8011-1af028204666" }, { "id": "36a0d6dd-323f-4724-aed4-9e4e50b471f2", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-36a0d6dd-323f-4724-aed4-9e4e50b471f2" }, { "id": "b5685f60-9cf4-4216-ba43-15d44f531a38", "name": "If authenticated user does not have access to the private snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-b5685f60-9cf4-4216-ba43-15d44f531a38" }, { "id": "36ed23ee-da5b-4359-ab5e-2a54456a5ebd", "name": "If the snippet, or the revision does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-36ed23ee-da5b-4359-ab5e-2a54456a5ebd" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-84f5ba79-f34a-4577-a0a8-8de13adb7d8c" }, { "name": "Atlassian Update A Previous Revision Of A Snippet", "id": "935b5c5f-182a-4e6b-a143-86dc4e43c70e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "id": "45a5eff7-41ca-4807-a736-5a60566c2acc", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "1351ce7e-8310-4907-9d79-efcb804f514a", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "12eea5b1-9299-4b57-8522-1f8b392ed00c", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Identical to `UPDATE /snippets/encoded_id`, except that this endpoint
takes an explicit commit revision. Only the snippet's \"HEAD\"/\"tip\"
(most recent) version can be updated and requests on all other,
older revisions fail by returning a 405 status.

Usage of this endpoint over the unrestricted `/snippets/encoded_id`
could be desired if the caller wants to be sure no concurrent
modifications have taken place between the moment of the UPDATE
request and the original GET.

This can be considered a so-called \"Compare And Swap\", or CAS
operation.

Other than that, the two endpoints are identical in behavior." }, "response": [ { "id": "a81137df-8736-48ed-82ef-019beab05b38", "name": "The updated snippet object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a81137df-8736-48ed-82ef-019beab05b38" }, { "id": "e73fb268-033a-4a5d-84d8-05dce028358a", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e73fb268-033a-4a5d-84d8-05dce028358a" }, { "id": "0014f1c1-ef34-45ce-8f84-5fb1432d78dd", "name": "If authenticated user does not have permission to update the private snippet.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-0014f1c1-ef34-45ce-8f84-5fb1432d78dd" }, { "id": "46920af4-5282-442a-bfa3-6a70a917aa2d", "name": "If the snippet or the revision does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-46920af4-5282-442a-bfa3-6a70a917aa2d" }, { "id": "063e683b-bdbc-4191-8e92-5b629cd2ece5", "name": "If `{node_id}` is not the latest revision.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:node_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":node_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "node_id" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-063e683b-bdbc-4191-8e92-5b629cd2ece5" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-935b5c5f-182a-4e6b-a143-86dc4e43c70e" } ], "id": "627c8eb1-b95d-4434-b77d-01be8337285c", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-627c8eb1-b95d-4434-b77d-01be8337285c" }, { "name": "{revision}", "item": [ { "name": "diff", "item": [ { "name": "Atlassian Get Snippet Changes Between Versions", "id": "56e09f15-4111-4579-917a-eb58915b6b9a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/diff?path=", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "diff" ], "query": [ { "description": "When used, only one the diff of the specified file will be returned.", "key": "path", "value": "" } ], "variable": [ { "id": "82d86bb2-0ece-4594-8fea-8188f3d26207", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "533d56eb-c2d8-4f18-8b5b-ad8d19b0341e", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "ebe09928-56fc-42db-b5d3-f4aca2d974b2", "key": "revision", "value": "", "description": "(Required) A revspec expression. This can simply be a commit SHA1, a ref name, or a compare expression like `staging..production`." } ] }, "description": "Returns the diff of the specified commit against its first parent.

Note that this resource is different in functionality from the `patch`
resource.

The differences between a diff and a patch are:

* patches have a commit header with the username, message, etc
* diffs support the optional `path=foo/bar.py` query param to filter the
diff to just that one file diff (not supported for patches)
* for a merge, the diff will show the diff between the merge commit and
its first parent (identical to how PRs work), while patch returns a
response containing separate patches for each commit on the second
parent's ancestry, up to the oldest common ancestor (identical to
its reachability).

Note that the character encoding of the contents of the diff is
unspecified as Git does not track this, making it hard for
Bitbucket to reliably determine this." }, "response": [ { "id": "e7a4848f-3c8b-43d7-9b0d-a213ddc5c749", "name": "The raw diff contents.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/diff?path=", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "diff" ], "query": [ { "description": "When used, only one the diff of the specified file will be returned.", "key": "path", "value": "" } ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-e7a4848f-3c8b-43d7-9b0d-a213ddc5c749" }, { "id": "876f333d-af68-4329-b24f-5d9f89ace53c", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/diff?path=", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "diff" ], "query": [ { "description": "When used, only one the diff of the specified file will be returned.", "key": "path", "value": "" } ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-876f333d-af68-4329-b24f-5d9f89ace53c" }, { "id": "58d85cc4-f5d8-4203-bcf9-6d14e18525df", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/diff?path=", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "diff" ], "query": [ { "description": "When used, only one the diff of the specified file will be returned.", "key": "path", "value": "" } ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-58d85cc4-f5d8-4203-bcf9-6d14e18525df" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-56e09f15-4111-4579-917a-eb58915b6b9a" } ], "id": "a99cc6f5-2270-42e1-be13-a05fa55be84f", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a99cc6f5-2270-42e1-be13-a05fa55be84f" }, { "name": "patch", "item": [ { "name": "Atlassian Get Snippet Patch Between Versions", "id": "98f9346d-b8ea-4bd3-8691-bbaa1ee1141f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/patch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "patch" ], "variable": [ { "id": "48c9ed0e-ec01-4352-a724-ad381ea26279", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "c9b43f00-14c6-47b0-a106-84e22928ab77", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "6cc56eba-42c4-41d4-8391-8fed960538d2", "key": "revision", "value": "", "description": "(Required) A revspec expression. This can simply be a commit SHA1, a ref name, or a compare expression like `staging..production`." } ] }, "description": "Returns the patch of the specified commit against its first
parent.

Note that this resource is different in functionality from the `diff`
resource.

The differences between a diff and a patch are:

* patches have a commit header with the username, message, etc
* diffs support the optional `path=foo/bar.py` query param to filter the
diff to just that one file diff (not supported for patches)
* for a merge, the diff will show the diff between the merge commit and
its first parent (identical to how PRs work), while patch returns a
response containing separate patches for each commit on the second
parent's ancestry, up to the oldest common ancestor (identical to
its reachability).

Note that the character encoding of the contents of the patch is
unspecified as Git does not track this, making it hard for
Bitbucket to reliably determine this." }, "response": [ { "id": "f82c6423-3686-49be-b843-490958190c93", "name": "The raw patch contents.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/patch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "patch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-f82c6423-3686-49be-b843-490958190c93" }, { "id": "729c8e3b-13ce-49bf-89b9-69d1668dd3b4", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/patch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "patch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-729c8e3b-13ce-49bf-89b9-69d1668dd3b4" }, { "id": "06c82b5a-395c-42db-a316-66b6f4a00c7e", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id/:revision/patch", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id", ":revision", "patch" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" }, { "key": "revision" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-06c82b5a-395c-42db-a316-66b6f4a00c7e" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-98f9346d-b8ea-4bd3-8691-bbaa1ee1141f" } ], "id": "dd2c9be8-2530-4fc7-92a1-cdefb0617357", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-dd2c9be8-2530-4fc7-92a1-cdefb0617357" } ], "id": "f0ed975c-13d2-4a7f-8a4c-ba87b1bfbd2e", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-f0ed975c-13d2-4a7f-8a4c-ba87b1bfbd2e" }, { "name": "Atlassian Delete A Snippet", "id": "178dadee-e77d-4e69-ab2f-9d8176cb8eba", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "d7e87c23-9e9c-42fa-88ad-ab8be59f9f5a", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "30bc3bef-aa8b-4f41-a50d-f33056876ab7", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Deletes a snippet and returns an empty response." }, "response": [ { "id": "5f695400-dd96-483a-8906-eb38cffdb1ac", "name": "If the snippet was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-5f695400-dd96-483a-8906-eb38cffdb1ac" }, { "id": "14c0e886-67bc-45c3-95d4-dd7a456fc8af", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-14c0e886-67bc-45c3-95d4-dd7a456fc8af" }, { "id": "b87a9fd8-0a7c-4881-a9ff-8b6f525b1446", "name": "If authenticated user does not have permission to delete the private snippet.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-b87a9fd8-0a7c-4881-a9ff-8b6f525b1446" }, { "id": "755b7a6b-57e8-4884-8843-d810cd4828f4", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-755b7a6b-57e8-4884-8843-d810cd4828f4" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-178dadee-e77d-4e69-ab2f-9d8176cb8eba" }, { "name": "Atlassian Get A Snippet", "id": "45526fbd-3dae-4b99-b512-d4a7229a6ac3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "f25e9f11-c02d-40ba-aac2-4bb1574d0904", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "814179fd-1c9c-4ea8-9759-82d7640fec3f", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Retrieves a single snippet.

Snippets support multiple content types:

* application/json
* multipart/related
* multipart/form-data


application/json
-

The default content type of the response is `application/json`.
Since JSON is always `utf-8`, it cannot reliably contain file contents
for files that are not text. Therefore, JSON snippet documents only
contain the filename and links to the file contents.

This means that in order to retrieve all parts of a snippet, N+1
requests need to be made (where N is the number of files in the
snippet).


multipart/related
--

To retrieve an entire snippet in a single response, use the
`Accept: multipart/related` HTTP request header.

$ curl -H \"Accept: multipart/related\" https://api.bitbucket.org/2.0/snippets/evzijst/1

Response:

HTTP/1.1 200 OK
Content-Length: 2214
Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"
MIME-Version: 1.0

--===============1438169132528273974==
Content-Type: application/json; charset=\"utf-8\"
MIME-Version: 1.0
Content-ID: snippet

{
\"links\": {
\"self\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj\"
},
\"html\": {
\"href\": \"https://bitbucket.org/snippets/evzijst/kypj\"
},
\"comments\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/comments\"
},
\"watchers\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/watchers\"
},
\"commits\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/commits\"
}
},
\"id\": kypj,
\"title\": \"My snippet\",
\"created_on\": \"2014-12-29T22:22:04.790331+00:00\",
\"updated_on\": \"2014-12-29T22:22:04.790331+00:00\",
\"is_private\": false,
\"files\": {
\"foo.txt\": {
\"links\": {
\"self\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/files/367ab19/foo.txt\"
},
\"html\": {
\"href\": \"https://bitbucket.org/snippets/evzijst/kypj#file-foo.txt\"
}
}
},
\"image.png\": {
\"links\": {
\"self\": {
\"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/files/367ab19/image.png\"
},
\"html\": {
\"href\": \"https://bitbucket.org/snippets/evzijst/kypj#file-image.png\"
}
}
}
],
\"owner\": {
\"username\": \"evzijst\",
\"nickname\": \"evzijst\",
\"display_name\": \"Erik van Zijst\",
\"uuid\": \"{d301aafa-d676-4ee0-88be-962be7417567}\",
\"links\": {
\"self\": {
\"href\": \"https://api.bitbucket.org/2.0/users/evzijst\"
},
\"html\": {
\"href\": \"https://bitbucket.org/evzijst\"
},
\"avatar\": {
\"href\": \"https://bitbucket-staging-assetroot.s3.amazonaws.com/c/photos/2013/Jul/31/erik-avatar-725122544-0_avatar.png\"
}
}
},
\"creator\": {
\"username\": \"evzijst\",
\"nickname\": \"evzijst\",
\"display_name\": \"Erik van Zijst\",
\"uuid\": \"{d301aafa-d676-4ee0-88be-962be7417567}\",
\"links\": {
\"self\": {
\"href\": \"https://api.bitbucket.org/2.0/users/evzijst\"
},
\"html\": {
\"href\": \"https://bitbucket.org/evzijst\"
},
\"avatar\": {
\"href\": \"https://bitbucket-staging-assetroot.s3.amazonaws.com/c/photos/2013/Jul/31/erik-avatar-725122544-0_avatar.png\"
}
}
}
}

--===============1438169132528273974==
Content-Type: text/plain; charset=\"us-ascii\"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-ID: \"foo.txt\"
Content-Disposition: attachment; filename=\"foo.txt\"

foo

--===============1438169132528273974==
Content-Type: image/png
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-ID: \"image.png\"
Content-Disposition: attachment; filename=\"image.png\"

iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAYAAAD+MdrbAAABD0lEQVR4Ae3VMUoDQRTG8ccUaW2m
TKONFxArJYJamCvkCnZTaa+VnQdJSBFl2SMsLFrEWNjZBZs0JgiL/+KrhhVmJRbCLPx4O+/DT2TB
cbblJxf+UWFVVRNsEGAtgvJxnLm2H+A5RQ93uIl+3632PZyl/skjfOn9Gvdwmlcw5aPUwimG+NT5
EnNN036IaZePUuIcK533NVfal7/5yjWeot2z9ta1cAczHEf7I+3J0ws9Cgx0fsOFpmlfwKcWPuBQ
73Oc4FHzBaZ8llq4q1mr5B2mOUCt815qYR8eB1hG2VJ7j35q4RofaH7IG+Xrf/PfJhfmwtfFYoIN
AqxFUD6OMxcvkO+UfKfkOyXfKdsv/AYCHMLVkHAFWgAAAABJRU5ErkJggg==
--===============1438169132528273974==--

multipart/form-data
-

As with creating new snippets, `multipart/form-data` can be used as an
alternative to `multipart/related`. However, the inherently flat
structure of form-data means that only basic, root-level properties
can be returned, while nested elements like `links` are omitted:

$ curl -H \"Accept: multipart/form-data\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj

Response:

HTTP/1.1 200 OK
Content-Length: 951
Content-Type: multipart/form-data; boundary=-63a4b224c59f

63a4b224c59f
Content-Disposition: form-data; name=\"title\"
Content-Type: text/plain; charset=\"utf-8\"

My snippet
63a4b224c59f--
Content-Disposition: attachment; name=\"file\"; filename=\"foo.txt\"
Content-Type: text/plain

foo

63a4b224c59f
Content-Disposition: attachment; name=\"file\"; filename=\"image.png\"
Content-Transfer-Encoding: base64
Content-Type: application/octet-stream

iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAYAAAD+MdrbAAABD0lEQVR4Ae3VMUoDQRTG8ccUaW2m
TKONFxArJYJamCvkCnZTaa+VnQdJSBFl2SMsLFrEWNjZBZs0JgiL/+KrhhVmJRbCLPx4O+/DT2TB
cbblJxf+UWFVVRNsEGAtgvJxnLm2H+A5RQ93uIl+3632PZyl/skjfOn9Gvdwmlcw5aPUwimG+NT5
EnNN036IaZePUuIcK533NVfal7/5yjWeot2z9ta1cAczHEf7I+3J0ws9Cgx0fsOFpmlfwKcWPuBQ
73Oc4FHzBaZ8llq4q1mr5B2mOUCt815qYR8eB1hG2VJ7j35q4RofaH7IG+Xrf/PfJhfmwtfFYoIN
AqxFUD6OMxcvkO+UfKfkOyXfKdsv/AYCHMLVkHAFWgAAAABJRU5ErkJggg==
5957323a6b76--" }, "response": [ { "id": "d8bbf1c9-1426-4c7e-827a-9a2029cfa908", "name": "The snippet object.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-d8bbf1c9-1426-4c7e-827a-9a2029cfa908" }, { "id": "acad36ef-9e70-45eb-80a2-399629323bc0", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-acad36ef-9e70-45eb-80a2-399629323bc0" }, { "id": "89079455-7fd0-4ce9-a819-bd87c4d805b2", "name": "If authenticated user does not have access to the private snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-89079455-7fd0-4ce9-a819-bd87c4d805b2" }, { "id": "255fbfc6-f7c1-4471-a1bc-09df0500906f", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-255fbfc6-f7c1-4471-a1bc-09df0500906f" }, { "id": "14f4e9ea-9023-46cf-b34b-4a6684d55bda", "name": "If the snippet marked as spam.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-14f4e9ea-9023-46cf-b34b-4a6684d55bda" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-45526fbd-3dae-4b99-b512-d4a7229a6ac3" }, { "name": "Atlassian Update A Snippet", "id": "c00afe52-7a3d-4b7e-9a71-4923552ce718", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "6bf996c0-4f22-4a11-b606-e1c197bf2ea0", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" }, { "id": "e4548ad5-9fee-4ff3-b387-e970bf184c51", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to update a snippet. Use this to add and delete files and to
change a snippet's title.

To update a snippet, one can either PUT a full snapshot, or only the
parts that need to be changed.

The contract for PUT on this API is that properties missing from the
request remain untouched so that snippets can be efficiently
manipulated with differential payloads.

To delete a property (e.g. the title, or a file), include its name in
the request, but omit its value (use `null`).

As in Git, explicit renaming of files is not supported. Instead, to
rename a file, delete it and add it again under another name. This can
be done atomically in a single request. Rename detection is left to
the SCM.

PUT supports three different content types for both request and
response bodies:

* `application/json`
* `multipart/related`
* `multipart/form-data`

The content type used for the request body can be different than that
used for the response. Content types are specified using standard HTTP
headers.

Use the `Content-Type` and `Accept` headers to select the desired
request and response format.


application/json
-

As with creation and retrieval, the content type determines what
properties can be manipulated. `application/json` does not support
file contents and is therefore limited to a snippet's meta data.

To update the title, without changing any of its files:

$ curl -X POST -H \"Content-Type: application/json\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj -d '{\"title\": \"Updated title\"}'


To delete the title:

$ curl -X POST -H \"Content-Type: application/json\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj -d '{\"title\": null}'

Not all parts of a snippet can be manipulated. The owner and creator
for instance are immutable.


multipart/related
--

`multipart/related` can be used to manipulate all of a snippet's
properties. The body is identical to a POST. properties omitted from
the request are left unchanged. Since the `start` part contains JSON,
the mechanism for manipulating the snippet's meta data is identical
to `application/json` requests.

To update one of a snippet's file contents, while also changing its
title:

PUT /2.0/snippets/evzijst/kypj HTTP/1.1
Content-Length: 288
Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"
MIME-Version: 1.0

--===============1438169132528273974==
Content-Type: application/json; charset=\"utf-8\"
MIME-Version: 1.0
Content-ID: snippet

{
\"title\": \"My updated snippet\",
\"files\": {
\"foo.txt\": {}
}
}

--===============1438169132528273974==
Content-Type: text/plain; charset=\"us-ascii\"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-ID: \"foo.txt\"
Content-Disposition: attachment; filename=\"foo.txt\"

Updated file contents.

--===============1438169132528273974==--

Here only the parts that are changed are included in the body. The
other files remain untouched.

Note the use of the `files` list in the JSON part. This list contains
the files that are being manipulated. This list should have
corresponding multiparts in the request that contain the new contents
of these files.

If a filename in the `files` list does not have a corresponding part,
it will be deleted from the snippet, as shown below:

PUT /2.0/snippets/evzijst/kypj HTTP/1.1
Content-Length: 188
Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"
MIME-Version: 1.0

--===============1438169132528273974==
Content-Type: application/json; charset=\"utf-8\"
MIME-Version: 1.0
Content-ID: snippet

{
\"files\": {
\"image.png\": {}
}
}

--===============1438169132528273974==--

To simulate a rename, delete a file and add the same file under
another name:

PUT /2.0/snippets/evzijst/kypj HTTP/1.1
Content-Length: 212
Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"
MIME-Version: 1.0

--===============1438169132528273974==
Content-Type: application/json; charset=\"utf-8\"
MIME-Version: 1.0
Content-ID: snippet

{
\"files\": {
\"foo.txt\": {},
\"bar.txt\": {}
}
}

--===============1438169132528273974==
Content-Type: text/plain; charset=\"us-ascii\"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-ID: \"bar.txt\"
Content-Disposition: attachment; filename=\"bar.txt\"

foo

--===============1438169132528273974==--


multipart/form-data
--

Again, one can also use `multipart/form-data` to manipulate file
contents and meta data atomically.

$ curl -X PUT http://localhost:12345/2.0/snippets/evzijst/kypj -F title=\"My updated snippet\" -F file=@foo.txt

PUT /2.0/snippets/evzijst/kypj HTTP/1.1
Content-Length: 351
Content-Type: multipart/form-data; boundary=-63a4b224c59f

63a4b224c59f
Content-Disposition: form-data; name=\"file\"; filename=\"foo.txt\"
Content-Type: text/plain

foo

63a4b224c59f
Content-Disposition: form-data; name=\"title\"

My updated snippet
63a4b224c59f

To delete a file, omit its contents while including its name in the
`files` field:

$ curl -X PUT https://api.bitbucket.org/2.0/snippets/evzijst/kypj -F files=image.png

PUT /2.0/snippets/evzijst/kypj HTTP/1.1
Content-Length: 149
Content-Type: multipart/form-data; boundary=-ef8871065a86

ef8871065a86
Content-Disposition: form-data; name=\"files\"

image.png
ef8871065a86--

The explicit use of the `files` element in `multipart/related` and
`multipart/form-data` is only required when deleting files.
The default mode of operation is for file parts to be processed,
regardless of whether or not they are listed in `files`, as a
convenience to the client." }, "response": [ { "id": "9d921787-e509-429d-8f87-b16d226bccce", "name": "The updated snippet object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-9d921787-e509-429d-8f87-b16d226bccce" }, { "id": "55624e76-2f72-4d7a-ba9e-a59f2b29f6f9", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-55624e76-2f72-4d7a-ba9e-a59f2b29f6f9" }, { "id": "85157a78-2a38-4e6d-8495-51ff3b398b8b", "name": "If authenticated user does not have permission to update the private snippet.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-85157a78-2a38-4e6d-8495-51ff3b398b8b" }, { "id": "beb512e4-4e44-4fa3-a1dd-ff84fd3e0650", "name": "If the snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "key": "workspace" }, { "key": "encoded_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-beb512e4-4e44-4fa3-a1dd-ff84fd3e0650" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-c00afe52-7a3d-4b7e-9a71-4923552ce718" } ], "id": "c4578f73-46dc-48bb-982c-8b61fbe6ade3", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-c4578f73-46dc-48bb-982c-8b61fbe6ade3" }, { "name": "Atlassian List Snippets In A Workspace", "id": "3f7b0117-36d7-439b-8ade-455bd4e49897", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ], "variable": [ { "id": "7c5db53c-12de-4e46-b727-714d861b5812", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" } ] }, "description": "Identical to [`/snippets`](/cloud/bitbucket/rest/api-group-snippets/#api-snippets-get), except that the result is further filtered
by the snippet owner and only those that are owned by `{workspace}` are
returned." }, "response": [ { "id": "9becab5e-49bb-4485-b489-f37aad3f63d9", "name": "A paginated list of snippets.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ], "variable": [ { "key": "workspace" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"size\": \"\",\n \"page\": \"\",\n \"pagelen\": \"\",\n \"next\": \"\",\n \"previous\": \"\",\n \"values\": [\n {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n },\n {\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-9becab5e-49bb-4485-b489-f37aad3f63d9" }, { "id": "a32a7d43-78d7-4cd4-a819-f51563ceaf13", "name": "If the user does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ], "variable": [ { "key": "workspace" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a32a7d43-78d7-4cd4-a819-f51563ceaf13" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-3f7b0117-36d7-439b-8ade-455bd4e49897" }, { "name": "Atlassian Create A Snippet For A Workspace", "id": "a635bd3e-b81a-4513-8062-193ed7ed2005", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "variable": [ { "id": "36784d6e-8610-45b4-bbc1-08f5b2cc3781", "key": "workspace", "value": "", "description": "(Required) This can either be the workspace ID (slug) or the workspace UUID\nsurrounded by curly-braces, for example: `{workspace UUID}`.\n" } ] }, "description": "Identical to [`/snippets`](/cloud/bitbucket/rest/api-group-snippets/#api-snippets-post), except that the new snippet will be
created under the workspace specified in the path parameter
`{workspace}`." }, "response": [ { "id": "a741aaa3-0999-4906-a76a-359f43d45022", "name": "The newly created snippet object.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "variable": [ { "key": "workspace" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "The URL of the newly created snippet.", "type": "text/plain" }, "key": "Location", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"creator\": {\n \"value\": \"reference #/components/schemas/account not found in the OpenAPI spec\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a741aaa3-0999-4906-a76a-359f43d45022" }, { "id": "97a2a149-52f1-4f9c-bed9-53655c9057fb", "name": "If the request was not authenticated", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "variable": [ { "key": "workspace" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-97a2a149-52f1-4f9c-bed9-53655c9057fb" }, { "id": "ac0c3278-e7c6-4c86-9107-107f206f26ac", "name": "If the authenticated user does not have permission to create snippets in the specified workspace.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "variable": [ { "key": "workspace" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"value\": \"reference #/components/schemas/error not found in the OpenAPI spec\"\n}", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-ac0c3278-e7c6-4c86-9107-107f206f26ac" } ], "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-a635bd3e-b81a-4513-8062-193ed7ed2005" } ], "id": "1d2ac630-57af-4b8b-8439-a6ad0a4432e9", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-1d2ac630-57af-4b8b-8439-a6ad0a4432e9" } ], "id": "ef29a6ef-b707-4a80-9395-f9f3e7e78c44", "createdAt": "2026-06-05T15:05:52.000Z", "updatedAt": "2026-06-05T15:05:52.000Z", "uid": "35240-ef29a6ef-b707-4a80-9395-f9f3e7e78c44" } ], "variable": [ { "key": "baseUrl", "value": "https://api.bitbucket.org/2.0" } ] }