{ "info": { "_postman_id": "4011d6d4-7090-4a56-91f3-38e5c6802ac7", "name": "Bitbucket Addon Snippets API", "description": "Code against the Bitbucket API to automate simple tasks, embed Bitbucket data into your own site, build mobile or desktop apps, or even add custom UI add-ons into Bitbucket itself using the Connect framework.\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-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "lastUpdatedBy": "35240", "uid": "35240-4011d6d4-7090-4a56-91f3-38e5c6802ac7" }, "item": [ { "name": "snippets", "item": [ { "name": "{workspace}", "item": [ { "name": "{encoded_id}", "item": [ { "name": "comments", "item": [ { "name": "{comment_id}", "item": [ { "name": "Delete a comment on a snippet", "id": "398ef995-420c-4bf6-b0d5-80d9f3dcde01", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "189c47f7-e568-4ead-af58-8e4a7a2cd1ce", "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": "355f76df-e50e-44bf-9e90-4a5ce8fc1046", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "c0047aa9-c2dc-4ebd-aa0b-9cb09f9089a4", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Deletes a snippet comment.\n\nComments can only be removed by the comment author, snippet creator, or workspace admin." }, "response": [ { "id": "cf2f8798-81d6-475d-a2ef-326e23a6e368", "name": "Indicates the comment was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-cf2f8798-81d6-475d-a2ef-326e23a6e368" }, { "id": "a1d3a5d2-ef5d-4a85-8b39-56d3f4956a30", "name": "If the authenticated user is not the author of the comment.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-a1d3a5d2-ef5d-4a85-8b39-56d3f4956a30" }, { "id": "d33afdf1-60ba-4af1-bb97-529bf1cb4d1b", "name": "If the comment or the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-d33afdf1-60ba-4af1-bb97-529bf1cb4d1b" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-398ef995-420c-4bf6-b0d5-80d9f3dcde01" }, { "name": "Get a comment on a snippet", "id": "017648e0-9e7c-4ed2-88f5-f4c6c0fc9077", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "0c639dae-c44e-4c0e-af0f-eec6d52b5b7e", "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": "edabfd1e-f5e5-4873-ba71-56d9a218815d", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "ca5f8f8b-bd18-4b8b-a561-44844853c0bc", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Returns the specific snippet comment." }, "response": [ { "id": "13f88622-4c8a-4b99-ad2c-e0380e5b2403", "name": "The specified comment.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-13f88622-4c8a-4b99-ad2c-e0380e5b2403" }, { "id": "8ae0f11a-de42-45ee-b441-c9812e80e11b", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-8ae0f11a-de42-45ee-b441-c9812e80e11b" }, { "id": "52519016-7689-4495-ae50-3b8a2c00ff4f", "name": "If the comment or snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-52519016-7689-4495-ae50-3b8a2c00ff4f" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-017648e0-9e7c-4ed2-88f5-f4c6c0fc9077" }, { "name": "Update a comment on a snippet", "id": "e987074d-5afe-4117-a20d-36f095e02fd9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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": "96096483-210a-475a-bef7-9928efae89a0", "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": "7570d975-8516-4640-892c-b8f9d4f98e85", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "4ecdf10d-5ef4-4608-a0a6-8b9f09031a2c", "key": "comment_id", "value": "", "description": "(Required) The id of the comment." } ] }, "description": "Updates a comment.\n\nThe only required field in the body is `content.raw`.\n\nComments can only be updated by their author." }, "response": [ { "id": "934f6cfd-8e66-42ec-a85f-bc23581535d9", "name": "The updated comment object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-934f6cfd-8e66-42ec-a85f-bc23581535d9" }, { "id": "6b256f2e-821f-4bb1-aa15-3f28912d92dd", "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" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-6b256f2e-821f-4bb1-aa15-3f28912d92dd" }, { "id": "25f836d1-957c-40e5-ab63-fcb7c2ba1b83", "name": "If the comment or snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-25f836d1-957c-40e5-ab63-fcb7c2ba1b83" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-e987074d-5afe-4117-a20d-36f095e02fd9" } ], "id": "78d0e5ca-d047-4d34-9aa7-4a8605c4557d", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-78d0e5ca-d047-4d34-9aa7-4a8605c4557d" }, { "name": "List comments on a snippet", "id": "fb1451dc-64d4-4cc9-9f89-9101d6953b7e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "2ed4cc31-8c53-43a6-8d70-5a8ed809e82c", "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": "cecee73b-e198-4526-9244-ee84690be499", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to retrieve a paginated list of all comments for a specific\nsnippet.\n\nThis resource works identical to commit and pull request comments.\n\nThe default sorting is oldest to newest and can be overridden with\nthe `sort` query parameter." }, "response": [ { "id": "8e77315e-899f-4174-ac1a-cf09cdf450e9", "name": "A paginated list of snippet comments, ordered by creation date.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n },\n {\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"ipsum_732\": \"ipsum non magna\",\n \"ut114\": -13650821,\n \"ipsumf07\": -57118604.221460514,\n \"tempor_a\": \"aute ad\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"laboris4\": 68259654\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-8e77315e-899f-4174-ac1a-cf09cdf450e9" }, { "id": "2199338d-f0d1-4bda-861d-040ba902b8d6", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-2199338d-f0d1-4bda-861d-040ba902b8d6" }, { "id": "f30dae34-1d03-47a6-a2c8-bfc65a697bcd", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-f30dae34-1d03-47a6-a2c8-bfc65a697bcd" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-fb1451dc-64d4-4cc9-9f89-9101d6953b7e" }, { "name": "Create a comment on a snippet", "id": "cbaa39e0-de27-4833-a05d-26e17a10169e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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": "84950c37-22e6-4b84-ab47-533f7ed0d14e", "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": "ccc98ee9-e753-4d48-b80b-19dd2909ab78", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Creates a new comment.\n\nThe only required field in the body is `content.raw`.\n\nTo create a threaded reply to an existing comment, include `parent.id`." }, "response": [ { "id": "3c4affab-93da-4962-9806-c6c3b90044ff", "name": "The newly created comment.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-3c4affab-93da-4962-9806-c6c3b90044ff" }, { "id": "0abd2c7e-df30-490f-83fd-86b53c63796c", "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" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-0abd2c7e-df30-490f-83fd-86b53c63796c" }, { "id": "25a09e30-ab79-4d11-b14d-3fd90d6f0c50", "name": "If the snippet does not exist.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"links\": {\n \"self\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"html\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"snippet\": {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"reprehenderit_f_\": \"sed incididun\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"officia978\": -10371534\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-25a09e30-ab79-4d11-b14d-3fd90d6f0c50" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-cbaa39e0-de27-4833-a05d-26e17a10169e" } ], "id": "2e2f6ba2-e381-4595-b79c-378a7d7f24f8", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-2e2f6ba2-e381-4595-b79c-378a7d7f24f8" }, { "name": "commits", "item": [ { "name": "{revision}", "item": [ { "name": "Get a previous snippet change", "id": "bf72d95f-f1db-4279-a965-6673a99d9f46", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "5f3673c2-70f6-461d-a0c2-9bef6c57ba82", "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": "8fbf2808-53d2-4ab7-94d8-c95b607bfe53", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "a0428e93-312d-4c4c-ab7e-a1f62fd24253", "key": "revision", "value": "", "description": "(Required) The commit's SHA1." } ] }, "description": "Returns the changes made on this snippet in this commit." }, "response": [ { "id": "151e8129-38db-4d4c-8c32-75c21bd4f994", "name": "The specified snippet commit.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"hash\": \"\",\n \"date\": \"\",\n \"author\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"irure327\": 50611561\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"committer\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"message\": \"\",\n \"summary\": {\n \"raw\": \"\",\n \"markup\": \"plaintext\",\n \"html\": \"\"\n },\n \"parents\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"sint8\": \"sunt\",\n \"quis3c\": -26889111,\n \"commodo_d\": \"labore consectetur culpa velit\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-151e8129-38db-4d4c-8c32-75c21bd4f994" }, { "id": "5289dd9e-7ae7-4d99-affb-e87af5a29e7a", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-5289dd9e-7ae7-4d99-affb-e87af5a29e7a" }, { "id": "10856e9d-44bd-4375-9536-4c354c46fc87", "name": "If the commit or the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-10856e9d-44bd-4375-9536-4c354c46fc87" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-bf72d95f-f1db-4279-a965-6673a99d9f46" } ], "id": "8265b29f-bf77-48e3-b7a0-13be00b51730", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-8265b29f-bf77-48e3-b7a0-13be00b51730" }, { "name": "List snippet changes", "id": "2fdb977c-1a0b-4ad5-a102-dbe19205c0c8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "2babf287-9113-4d7f-9afd-b63863c9d69a", "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": "30de1bf5-4745-4bc6-b310-c98b92ee4ea3", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Returns the changes (commits) made on this snippet." }, "response": [ { "id": "9f572661-ae3a-41f6-ab27-42c771e4750c", "name": "The paginated list of snippet commits.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"hash\": \"\",\n \"date\": \"\",\n \"author\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"laborum_ea\": -79259218,\n \"irure8\": -66242582,\n \"esse_4d3\": \"commodo irure incididunt mollit\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"committer\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"in20c\": false\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"message\": \"\",\n \"summary\": {\n \"raw\": \"\",\n \"markup\": \"creole\",\n \"html\": \"\"\n },\n \"parents\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"veniam_8\": true,\n \"cupidatat__8\": -85590149,\n \"quisc8\": false,\n \"adipisicing56\": true\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"ex_f1\": \"cupidatat\",\n \"ullamco_1\": false,\n \"eiusmod_d\": false\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n },\n {\n \"type\": \"\",\n \"hash\": \"\",\n \"date\": \"\",\n \"author\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"elitb53\": true\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"committer\": {\n \"type\": \"\",\n \"raw\": \"\",\n \"user\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n },\n \"message\": \"\",\n \"summary\": {\n \"raw\": \"\",\n \"markup\": \"creole\",\n \"html\": \"\"\n },\n \"parents\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"est_1d3\": true,\n \"proident20\": true,\n \"exf1\": true\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"magna0\": true,\n \"ex_54\": -54991556\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-9f572661-ae3a-41f6-ab27-42c771e4750c" }, { "id": "d8b73078-b88e-466f-b5de-f94011370aff", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-d8b73078-b88e-466f-b5de-f94011370aff" }, { "id": "f0badd59-6f90-4e96-818a-594afa182e34", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-f0badd59-6f90-4e96-818a-594afa182e34" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-2fdb977c-1a0b-4ad5-a102-dbe19205c0c8" } ], "id": "64f90e98-d1f3-4887-8999-8f0e152da965", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-64f90e98-d1f3-4887-8999-8f0e152da965" }, { "name": "files", "item": [ { "name": "{path}", "item": [ { "name": "Get a snippet's raw file at HEAD", "id": "501982e4-f8cc-441a-9f11-62dfee38a076", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "24c06552-8240-42a0-8d29-e4345af5c490", "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": "b40efd70-240b-4e6c-bbaa-41fcde60b692", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "cb2975af-3355-4068-97a2-84532f7812f7", "key": "path", "value": "", "description": "(Required) Path to the file." } ] }, "description": "Convenience resource for getting to a snippet's raw files without the\nneed for first having to retrieve the snippet itself and having to pull\nout the versioned file links." }, "response": [ { "id": "5cd7457e-5bd7-4eae-939b-8e7f9282e88d", "name": "A redirect to the most recent revision of the specified file.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-5cd7457e-5bd7-4eae-939b-8e7f9282e88d" }, { "id": "2897a026-b17e-47b2-9781-9fd13949a4cd", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-2897a026-b17e-47b2-9781-9fd13949a4cd" }, { "id": "e2330140-004f-41a2-9a1e-0fba2a926937", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-e2330140-004f-41a2-9a1e-0fba2a926937" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-501982e4-f8cc-441a-9f11-62dfee38a076" } ], "id": "c8d4a337-0b7c-407f-b898-7ed1311a36b0", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-c8d4a337-0b7c-407f-b898-7ed1311a36b0" } ], "id": "3f0e5bdd-ae2b-4c54-84b9-36cbc37df29d", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-3f0e5bdd-ae2b-4c54-84b9-36cbc37df29d" }, { "name": "watch", "item": [ { "name": "Stop watching a snippet", "id": "133c0a37-d98a-443b-81e8-f3e1db815d31", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "14b70eae-70ad-4628-b9e6-885f34be9a1d", "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": "41e31b84-8ec4-4087-8bef-53ddd11f11f8", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to stop watching a specific snippet. Returns 204 (No Content)\nto indicate success." }, "response": [ { "id": "7bb1461a-f922-4aa5-80db-50ba7790af29", "name": "Indicates the user stopped watching the snippet successfully.", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-7bb1461a-f922-4aa5-80db-50ba7790af29" }, { "id": "1391c49b-5960-42c8-a7c9-d7cb4f960d75", "name": "If the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-1391c49b-5960-42c8-a7c9-d7cb4f960d75" }, { "id": "0b6b7b93-aa49-4b47-9d99-a0be52c18719", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-0b6b7b93-aa49-4b47-9d99-a0be52c18719" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-133c0a37-d98a-443b-81e8-f3e1db815d31" }, { "name": "Check if the current user is watching a snippet", "id": "ab206822-557a-4e32-8220-735880e4e7e4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "0a23b2c2-c9fe-49fe-9856-f017b7ddc016", "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": "ea5ca4d3-ae68-4a7c-8174-f451db65e169", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to check if the current user is watching a specific snippet.\n\nReturns 204 (No Content) if the user is watching the snippet and 404 if\nnot.\n\nHitting this endpoint anonymously always returns a 404." }, "response": [ { "id": "68b6bfee-87b4-4c10-8292-67efbcac2f17", "name": "If the authenticated user is watching the snippet.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-68b6bfee-87b4-4c10-8292-67efbcac2f17" }, { "id": "4c8d4ab7-99ef-44df-a21f-7b38550991c6", "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" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-4c8d4ab7-99ef-44df-a21f-7b38550991c6" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-ab206822-557a-4e32-8220-735880e4e7e4" }, { "name": "Watch a snippet", "id": "ce3bd709-7aab-43cb-9ffc-0b6e5c35632f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "2604b07c-1f3c-42d7-8351-13c5f1b4327c", "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": "24f1826b-448f-4a34-8486-a9ea14580eb5", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to start watching a specific snippet. Returns 204 (No Content)." }, "response": [ { "id": "d0194fd1-7258-4934-a196-71ceece21888", "name": "Indicates the authenticated user is now watching the snippet.", "originalRequest": { "method": "PUT", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-d0194fd1-7258-4934-a196-71ceece21888" }, { "id": "a0f148ab-48e1-4a9d-a5b1-550871f33015", "name": "If the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-a0f148ab-48e1-4a9d-a5b1-550871f33015" }, { "id": "c514b597-0c43-4570-b007-0988552775e3", "name": "If the snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-c514b597-0c43-4570-b007-0988552775e3" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-ce3bd709-7aab-43cb-9ffc-0b6e5c35632f" } ], "id": "5f6a5c54-be03-4b7b-8b9f-944b8db7ff40", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-5f6a5c54-be03-4b7b-8b9f-944b8db7ff40" }, { "name": "watchers", "item": [ { "name": "List users watching a snippet", "id": "7f841f4c-3739-4a28-9a49-0df846596aa9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "2c7c94ea-f975-4c92-96d2-86411d87737e", "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": "dfadb43b-649f-4db8-af2e-e95646408bf3", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Returns a paginated list of all users watching a specific snippet." }, "response": [ { "id": "ae0f322c-3175-4422-bde4-7ef1ac0c397b", "name": "The paginated list of users watching this snippet", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"culpa_34c\": 88665585.12638187,\n \"ute3\": -11882349.855537727,\n \"ullamco_06\": -47389874.5508516\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolor_0_\": \"aliqua minim culpa qui\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-ae0f322c-3175-4422-bde4-7ef1ac0c397b" }, { "id": "e2d4d3e3-8e35-4c5a-9b0c-675565c55b54", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-e2d4d3e3-8e35-4c5a-9b0c-675565c55b54" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7f841f4c-3739-4a28-9a49-0df846596aa9" } ], "id": "aa20d55a-3703-43b9-809c-81fc31dca6f3", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-aa20d55a-3703-43b9-809c-81fc31dca6f3" }, { "name": "{node_id}", "item": [ { "name": "files", "item": [ { "name": "{path}", "item": [ { "name": "Get a snippet's raw file", "id": "dba3a9c9-ba5d-4df3-a86a-710e17a4e838", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "2e5e24d3-33e4-4dc3-aa6b-361cad9c9f39", "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": "59c21ed0-9b42-4adb-8537-24d635991248", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "79cf7570-b0c5-4f67-a776-bd5ffd79c077", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." }, { "id": "00c0cde0-ef64-46c7-9253-5f4c67ed400e", "key": "path", "value": "", "description": "(Required) Path to the file." } ] }, "description": "Retrieves the raw contents of a specific file in the snippet. The\n`Content-Disposition` header will be \"attachment\" to avoid issues with\nmalevolent executable files.\n\nThe file's mime type is derived from its filename and returned in the\n`Content-Type` header.\n\nNote that for text files, no character encoding is included as part of\nthe content type." }, "response": [ { "id": "e78459d4-bce1-4e8b-bdf2-1ca1e954fde8", "name": "Returns the contents of the specified file.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-e78459d4-bce1-4e8b-bdf2-1ca1e954fde8" }, { "id": "5d641933-72c9-4078-b608-f3e808bc8cb1", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-5d641933-72c9-4078-b608-f3e808bc8cb1" }, { "id": "7d98bcc6-d182-496f-b983-df23b6bc910a", "name": "If the file or snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-7d98bcc6-d182-496f-b983-df23b6bc910a" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-dba3a9c9-ba5d-4df3-a86a-710e17a4e838" } ], "id": "74e1b19f-f756-4a1c-a3de-ec11b184d84d", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-74e1b19f-f756-4a1c-a3de-ec11b184d84d" } ], "id": "ac5d28e7-9455-4ee5-a09c-bc5587e354ec", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-ac5d28e7-9455-4ee5-a09c-bc5587e354ec" }, { "name": "Delete a previous revision of a snippet", "id": "7301cb99-eb8a-4966-a900-5bc3ff615210", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "c8a818c9-d541-4524-a117-d410bc0227db", "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": "add65dfd-bc83-446d-98e4-f09cf6db80d4", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "21336875-70a5-4cf6-86df-65d2e67a059e", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Deletes the snippet.\n\nNote that this only works for versioned URLs that point to the latest\ncommit of the snippet. Pointing to an older commit results in a 405\nstatus code.\n\nTo delete a snippet, regardless of whether or not concurrent changes\nare being made to it, use `DELETE /snippets/{encoded_id}` instead." }, "response": [ { "id": "4eb2be40-1da2-46b9-82ad-bf484a72b2d2", "name": "If the snippet was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-4eb2be40-1da2-46b9-82ad-bf484a72b2d2" }, { "id": "b1a44e3f-04bb-4e91-b9b0-30c5fbb0f5cc", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-b1a44e3f-04bb-4e91-b9b0-30c5fbb0f5cc" }, { "id": "6faaf6fe-b927-4269-bc6d-7da74fb09f49", "name": "If authenticated user does not have permission to delete the private snippet.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-6faaf6fe-b927-4269-bc6d-7da74fb09f49" }, { "id": "0f2f418d-e9d4-4b94-8346-09a42fe1b06d", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-0f2f418d-e9d4-4b94-8346-09a42fe1b06d" }, { "id": "01bf9750-8b84-498e-89cf-c8fe34ed1b15", "name": "If `{node_id}` is not the latest revision.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-01bf9750-8b84-498e-89cf-c8fe34ed1b15" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7301cb99-eb8a-4966-a900-5bc3ff615210" }, { "name": "Get a previous revision of a snippet", "id": "699e56f8-8c3c-4d44-b333-8d0ed33354da", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "64c6a42e-6a1b-440a-be1e-acbc8d104fe3", "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": "7851d4ac-b148-44c4-a231-c5fffacfaccb", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "f0fdbba7-891d-4fcf-99ec-9e6e819bc8e1", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Identical to `GET /snippets/encoded_id`, except that this endpoint\ncan be used to retrieve the contents of the snippet as it was at an\nolder revision, while `/snippets/encoded_id` always returns the\nsnippet's current revision.\n\nNote that only the snippet's file contents are versioned, not its\nmeta data properties like the title.\n\nOther than that, the two endpoints are identical in behavior." }, "response": [ { "id": "c99b6257-e3cc-4d46-a670-219aa323a379", "name": "The snippet object.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-c99b6257-e3cc-4d46-a670-219aa323a379" }, { "id": "dc5c4b55-8345-4c92-93b1-c6da62ee5cc9", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-dc5c4b55-8345-4c92-93b1-c6da62ee5cc9" }, { "id": "4b513f7f-e86c-4412-9c1d-40128ec86777", "name": "If authenticated user does not have access to the private snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-4b513f7f-e86c-4412-9c1d-40128ec86777" }, { "id": "221ae18a-853b-424b-9238-d08af2efb343", "name": "If the snippet, or the revision does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-221ae18a-853b-424b-9238-d08af2efb343" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-699e56f8-8c3c-4d44-b333-8d0ed33354da" }, { "name": "Update a previous revision of a snippet", "id": "a456fd24-7b95-4458-8d2a-fcbc4f971106", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "16f565a1-8086-443f-b2a0-01511cd7a61d", "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": "e9f34f5c-4f28-489b-87a4-6829f396e032", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "df21eb0a-a487-4f46-8589-4772fe9021ec", "key": "node_id", "value": "", "description": "(Required) A commit revision (SHA1)." } ] }, "description": "Identical to `UPDATE /snippets/encoded_id`, except that this endpoint\ntakes an explicit commit revision. Only the snippet's \"HEAD\"/\"tip\"\n(most recent) version can be updated and requests on all other,\nolder revisions fail by returning a 405 status.\n\nUsage of this endpoint over the unrestricted `/snippets/encoded_id`\ncould be desired if the caller wants to be sure no concurrent\nmodifications have taken place between the moment of the UPDATE\nrequest and the original GET.\n\nThis can be considered a so-called \"Compare And Swap\", or CAS\noperation.\n\nOther than that, the two endpoints are identical in behavior." }, "response": [ { "id": "69b5ed1f-041c-420e-a20b-ce115e4831fa", "name": "The updated snippet object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-69b5ed1f-041c-420e-a20b-ce115e4831fa" }, { "id": "7f039114-05f8-4e1c-b723-c3fc40eb5ca4", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-7f039114-05f8-4e1c-b723-c3fc40eb5ca4" }, { "id": "2fa13532-be22-42de-b382-bb9bed597c75", "name": "If authenticated user does not have permission to update the private snippet.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-2fa13532-be22-42de-b382-bb9bed597c75" }, { "id": "834cb9ea-c586-419a-b320-3aa644ffe82a", "name": "If the snippet or the revision does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-834cb9ea-c586-419a-b320-3aa644ffe82a" }, { "id": "3368b525-f30a-4779-aff4-8ed9941808ef", "name": "If `{node_id}` is not the latest revision.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-3368b525-f30a-4779-aff4-8ed9941808ef" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-a456fd24-7b95-4458-8d2a-fcbc4f971106" } ], "id": "32fc2ef4-501e-4aef-a218-7a1d208fe8ad", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-32fc2ef4-501e-4aef-a218-7a1d208fe8ad" }, { "name": "{revision}", "item": [ { "name": "diff", "item": [ { "name": "Get snippet changes between versions", "id": "dd4fa0d6-b7de-4d44-b231-74c9b3809148", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "f2c28106-384a-4cee-b493-2c9501486b1a", "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": "4acd8615-3bc6-40e6-8398-2a0d489cbe86", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "a111cd1d-7ae8-4757-81e7-875e48880b3f", "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.\n\nNote that this resource is different in functionality from the `patch`\nresource.\n\nThe differences between a diff and a patch are:\n\n* patches have a commit header with the username, message, etc\n* diffs support the optional `path=foo/bar.py` query param to filter the\n diff to just that one file diff (not supported for patches)\n* for a merge, the diff will show the diff between the merge commit and\n its first parent (identical to how PRs work), while patch returns a\n response containing separate patches for each commit on the second\n parent's ancestry, up to the oldest common ancestor (identical to\n its reachability).\n\nNote that the character encoding of the contents of the diff is\nunspecified as Git does not track this, making it hard for\nBitbucket to reliably determine this." }, "response": [ { "id": "5107df66-9535-4d69-954b-170ea664ba4a", "name": "The raw diff contents.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-5107df66-9535-4d69-954b-170ea664ba4a" }, { "id": "6ea7ec7a-a462-44f8-b8c8-4c57871fa0e8", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-6ea7ec7a-a462-44f8-b8c8-4c57871fa0e8" }, { "id": "ffc563e0-a1d8-4fb5-b23f-57d3bd1546a7", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-ffc563e0-a1d8-4fb5-b23f-57d3bd1546a7" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-dd4fa0d6-b7de-4d44-b231-74c9b3809148" } ], "id": "8dc48b1e-a530-4f05-b961-c3a214451775", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-8dc48b1e-a530-4f05-b961-c3a214451775" }, { "name": "patch", "item": [ { "name": "Get snippet patch between versions", "id": "8988cef4-50c9-4529-aa8e-10f68d13273c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "4cb9f991-c3ed-49ee-acff-90d403b59001", "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": "8e137f31-da2f-4f33-9845-2365fe9cd33e", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." }, { "id": "8edb1f15-89e5-4e5f-a84c-6ab1178f3263", "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\nparent.\n\nNote that this resource is different in functionality from the `diff`\nresource.\n\nThe differences between a diff and a patch are:\n\n* patches have a commit header with the username, message, etc\n* diffs support the optional `path=foo/bar.py` query param to filter the\n diff to just that one file diff (not supported for patches)\n* for a merge, the diff will show the diff between the merge commit and\n its first parent (identical to how PRs work), while patch returns a\n response containing separate patches for each commit on the second\n parent's ancestry, up to the oldest common ancestor (identical to\n its reachability).\n\nNote that the character encoding of the contents of the patch is\nunspecified as Git does not track this, making it hard for\nBitbucket to reliably determine this." }, "response": [ { "id": "01ab42ce-e1a5-4e62-b3a8-aedeb50e4273", "name": "The raw patch contents.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-01ab42ce-e1a5-4e62-b3a8-aedeb50e4273" }, { "id": "19db31c8-61c3-41f1-8fb9-9f528f1f3205", "name": "If the authenticated user does not have access to the snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-19db31c8-61c3-41f1-8fb9-9f528f1f3205" }, { "id": "3b2c691c-4050-41c0-b879-a2928ae3714e", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-3b2c691c-4050-41c0-b879-a2928ae3714e" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-8988cef4-50c9-4529-aa8e-10f68d13273c" } ], "id": "7668c6f2-5308-4f79-9ca3-b595536832a6", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7668c6f2-5308-4f79-9ca3-b595536832a6" } ], "id": "a84d715c-4b97-45d6-a44e-96e4e3f6d0d2", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-a84d715c-4b97-45d6-a44e-96e4e3f6d0d2" }, { "name": "Delete a snippet", "id": "494514d3-a7dc-44a5-aa0e-5f2989a4756f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "4fe53afe-98e7-4618-8471-37391400e983", "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": "7308d2f8-93b9-42f9-9e32-334bdf33b435", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Deletes a snippet and returns an empty response." }, "response": [ { "id": "a16d0616-1f07-4b46-8ac2-16628171c3a7", "name": "If the snippet was deleted successfully.", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-a16d0616-1f07-4b46-8ac2-16628171c3a7" }, { "id": "678fd856-c05d-499a-9edb-279717c5034b", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-678fd856-c05d-499a-9edb-279717c5034b" }, { "id": "33cbfdab-78c0-4b7a-ab8a-ff0ea3342702", "name": "If authenticated user does not have permission to delete the private snippet.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-33cbfdab-78c0-4b7a-ab8a-ff0ea3342702" }, { "id": "8ee72f52-44d0-441f-bd6e-e0ce056e743a", "name": "If the snippet does not exist.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-8ee72f52-44d0-441f-bd6e-e0ce056e743a" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-494514d3-a7dc-44a5-aa0e-5f2989a4756f" }, { "name": "Get a snippet", "id": "e180447b-2fa3-46c9-af9c-a39b13f33529", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "097526e7-2d71-48c7-94d2-b77114dc5a25", "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": "09a96d5b-e6c2-4bb9-a773-e915ba341f87", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Retrieves a single snippet.\n\nSnippets support multiple content types:\n\n* application/json\n* multipart/related\n* multipart/form-data\n\n\napplication/json\n----------------\n\nThe default content type of the response is `application/json`.\nSince JSON is always `utf-8`, it cannot reliably contain file contents\nfor files that are not text. Therefore, JSON snippet documents only\ncontain the filename and links to the file contents.\n\nThis means that in order to retrieve all parts of a snippet, N+1\nrequests need to be made (where N is the number of files in the\nsnippet).\n\n\nmultipart/related\n-----------------\n\nTo retrieve an entire snippet in a single response, use the\n`Accept: multipart/related` HTTP request header.\n\n $ curl -H \"Accept: multipart/related\" https://api.bitbucket.org/2.0/snippets/evzijst/1\n\nResponse:\n\n HTTP/1.1 200 OK\n Content-Length: 2214\n Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"\n MIME-Version: 1.0\n\n --===============1438169132528273974==\n Content-Type: application/json; charset=\"utf-8\"\n MIME-Version: 1.0\n Content-ID: snippet\n\n {\n \"links\": {\n \"self\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj\"\n },\n \"html\": {\n \"href\": \"https://bitbucket.org/snippets/evzijst/kypj\"\n },\n \"comments\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/comments\"\n },\n \"watchers\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/watchers\"\n },\n \"commits\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/commits\"\n }\n },\n \"id\": kypj,\n \"title\": \"My snippet\",\n \"created_on\": \"2014-12-29T22:22:04.790331+00:00\",\n \"updated_on\": \"2014-12-29T22:22:04.790331+00:00\",\n \"is_private\": false,\n \"files\": {\n \"foo.txt\": {\n \"links\": {\n \"self\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/files/367ab19/foo.txt\"\n },\n \"html\": {\n \"href\": \"https://bitbucket.org/snippets/evzijst/kypj#file-foo.txt\"\n }\n }\n },\n \"image.png\": {\n \"links\": {\n \"self\": {\n \"href\": \"https://api.bitbucket.org/2.0/snippets/evzijst/kypj/files/367ab19/image.png\"\n },\n \"html\": {\n \"href\": \"https://bitbucket.org/snippets/evzijst/kypj#file-image.png\"\n }\n }\n }\n ],\n \"owner\": {\n \"username\": \"evzijst\",\n \"nickname\": \"evzijst\",\n \"display_name\": \"Erik van Zijst\",\n \"uuid\": \"{d301aafa-d676-4ee0-88be-962be7417567}\",\n \"links\": {\n \"self\": {\n \"href\": \"https://api.bitbucket.org/2.0/users/evzijst\"\n },\n \"html\": {\n \"href\": \"https://bitbucket.org/evzijst\"\n },\n \"avatar\": {\n \"href\": \"https://bitbucket-staging-assetroot.s3.amazonaws.com/c/photos/2013/Jul/31/erik-avatar-725122544-0_avatar.png\"\n }\n }\n },\n \"creator\": {\n \"username\": \"evzijst\",\n \"nickname\": \"evzijst\",\n \"display_name\": \"Erik van Zijst\",\n \"uuid\": \"{d301aafa-d676-4ee0-88be-962be7417567}\",\n \"links\": {\n \"self\": {\n \"href\": \"https://api.bitbucket.org/2.0/users/evzijst\"\n },\n \"html\": {\n \"href\": \"https://bitbucket.org/evzijst\"\n },\n \"avatar\": {\n \"href\": \"https://bitbucket-staging-assetroot.s3.amazonaws.com/c/photos/2013/Jul/31/erik-avatar-725122544-0_avatar.png\"\n }\n }\n }\n }\n\n --===============1438169132528273974==\n Content-Type: text/plain; charset=\"us-ascii\"\n MIME-Version: 1.0\n Content-Transfer-Encoding: 7bit\n Content-ID: \"foo.txt\"\n Content-Disposition: attachment; filename=\"foo.txt\"\n\n foo\n\n --===============1438169132528273974==\n Content-Type: image/png\n MIME-Version: 1.0\n Content-Transfer-Encoding: base64\n Content-ID: \"image.png\"\n Content-Disposition: attachment; filename=\"image.png\"\n\n iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAYAAAD+MdrbAAABD0lEQVR4Ae3VMUoDQRTG8ccUaW2m\n TKONFxArJYJamCvkCnZTaa+VnQdJSBFl2SMsLFrEWNjZBZs0JgiL/+KrhhVmJRbCLPx4O+/DT2TB\n cbblJxf+UWFVVRNsEGAtgvJxnLm2H+A5RQ93uIl+3632PZyl/skjfOn9Gvdwmlcw5aPUwimG+NT5\n EnNN036IaZePUuIcK533NVfal7/5yjWeot2z9ta1cAczHEf7I+3J0ws9Cgx0fsOFpmlfwKcWPuBQ\n 73Oc4FHzBaZ8llq4q1mr5B2mOUCt815qYR8eB1hG2VJ7j35q4RofaH7IG+Xrf/PfJhfmwtfFYoIN\n AqxFUD6OMxcvkO+UfKfkOyXfKdsv/AYCHMLVkHAFWgAAAABJRU5ErkJggg==\n --===============1438169132528273974==--\n\nmultipart/form-data\n-------------------\n\nAs with creating new snippets, `multipart/form-data` can be used as an\nalternative to `multipart/related`. However, the inherently flat\nstructure of form-data means that only basic, root-level properties\ncan be returned, while nested elements like `links` are omitted:\n\n $ curl -H \"Accept: multipart/form-data\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj\n\nResponse:\n\n HTTP/1.1 200 OK\n Content-Length: 951\n Content-Type: multipart/form-data; boundary=----------------------------63a4b224c59f\n\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"title\"\n Content-Type: text/plain; charset=\"utf-8\"\n\n My snippet\n ------------------------------63a4b224c59f--\n Content-Disposition: attachment; name=\"file\"; filename=\"foo.txt\"\n Content-Type: text/plain\n\n foo\n\n ------------------------------63a4b224c59f\n Content-Disposition: attachment; name=\"file\"; filename=\"image.png\"\n Content-Transfer-Encoding: base64\n Content-Type: application/octet-stream\n\n iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAYAAAD+MdrbAAABD0lEQVR4Ae3VMUoDQRTG8ccUaW2m\n TKONFxArJYJamCvkCnZTaa+VnQdJSBFl2SMsLFrEWNjZBZs0JgiL/+KrhhVmJRbCLPx4O+/DT2TB\n cbblJxf+UWFVVRNsEGAtgvJxnLm2H+A5RQ93uIl+3632PZyl/skjfOn9Gvdwmlcw5aPUwimG+NT5\n EnNN036IaZePUuIcK533NVfal7/5yjWeot2z9ta1cAczHEf7I+3J0ws9Cgx0fsOFpmlfwKcWPuBQ\n 73Oc4FHzBaZ8llq4q1mr5B2mOUCt815qYR8eB1hG2VJ7j35q4RofaH7IG+Xrf/PfJhfmwtfFYoIN\n AqxFUD6OMxcvkO+UfKfkOyXfKdsv/AYCHMLVkHAFWgAAAABJRU5ErkJggg==\n ------------------------------5957323a6b76--" }, "response": [ { "id": "dc17c1e3-c189-4402-8586-d44c83a06939", "name": "The snippet object.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-dc17c1e3-c189-4402-8586-d44c83a06939" }, { "id": "1129d166-3d4d-4797-b1d6-324420337679", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-1129d166-3d4d-4797-b1d6-324420337679" }, { "id": "4c03b13b-7d2c-46be-83dd-cd0cc9696284", "name": "If authenticated user does not have access to the private snippet.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-4c03b13b-7d2c-46be-83dd-cd0cc9696284" }, { "id": "10d68c7b-a885-4d5e-bf0c-a9bcd318c713", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-10d68c7b-a885-4d5e-bf0c-a9bcd318c713" }, { "id": "7f5a1c74-b9b7-4f3c-936c-19418f416364", "name": "If the snippet marked as spam.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-7f5a1c74-b9b7-4f3c-936c-19418f416364" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-e180447b-2fa3-46c9-af9c-a39b13f33529" }, { "name": "Update a snippet", "id": "3369bd71-71d8-47d9-b4e3-9dda23e4a969", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets/:workspace/:encoded_id", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace", ":encoded_id" ], "variable": [ { "id": "8162b0e4-8f48-485a-a5e3-dcd00c828a94", "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": "0c8263c2-492c-4ee3-bcf4-1509a583d23d", "key": "encoded_id", "value": "", "description": "(Required) The snippet id." } ] }, "description": "Used to update a snippet. Use this to add and delete files and to\nchange a snippet's title.\n\nTo update a snippet, one can either PUT a full snapshot, or only the\nparts that need to be changed.\n\nThe contract for PUT on this API is that properties missing from the\nrequest remain untouched so that snippets can be efficiently\nmanipulated with differential payloads.\n\nTo delete a property (e.g. the title, or a file), include its name in\nthe request, but omit its value (use `null`).\n\nAs in Git, explicit renaming of files is not supported. Instead, to\nrename a file, delete it and add it again under another name. This can\nbe done atomically in a single request. Rename detection is left to\nthe SCM.\n\nPUT supports three different content types for both request and\nresponse bodies:\n\n* `application/json`\n* `multipart/related`\n* `multipart/form-data`\n\nThe content type used for the request body can be different than that\nused for the response. Content types are specified using standard HTTP\nheaders.\n\nUse the `Content-Type` and `Accept` headers to select the desired\nrequest and response format.\n\n\napplication/json\n----------------\n\nAs with creation and retrieval, the content type determines what\nproperties can be manipulated. `application/json` does not support\nfile contents and is therefore limited to a snippet's meta data.\n\nTo update the title, without changing any of its files:\n\n $ curl -X POST -H \"Content-Type: application/json\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj -d '{\"title\": \"Updated title\"}'\n\n\nTo delete the title:\n\n $ curl -X POST -H \"Content-Type: application/json\" https://api.bitbucket.org/2.0/snippets/evzijst/kypj -d '{\"title\": null}'\n\nNot all parts of a snippet can be manipulated. The owner and creator\nfor instance are immutable.\n\n\nmultipart/related\n-----------------\n\n`multipart/related` can be used to manipulate all of a snippet's\nproperties. The body is identical to a POST. properties omitted from\nthe request are left unchanged. Since the `start` part contains JSON,\nthe mechanism for manipulating the snippet's meta data is identical\nto `application/json` requests.\n\nTo update one of a snippet's file contents, while also changing its\ntitle:\n\n PUT /2.0/snippets/evzijst/kypj HTTP/1.1\n Content-Length: 288\n Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"\n MIME-Version: 1.0\n\n --===============1438169132528273974==\n Content-Type: application/json; charset=\"utf-8\"\n MIME-Version: 1.0\n Content-ID: snippet\n\n {\n \"title\": \"My updated snippet\",\n \"files\": {\n \"foo.txt\": {}\n }\n }\n\n --===============1438169132528273974==\n Content-Type: text/plain; charset=\"us-ascii\"\n MIME-Version: 1.0\n Content-Transfer-Encoding: 7bit\n Content-ID: \"foo.txt\"\n Content-Disposition: attachment; filename=\"foo.txt\"\n\n Updated file contents.\n\n --===============1438169132528273974==--\n\nHere only the parts that are changed are included in the body. The\nother files remain untouched.\n\nNote the use of the `files` list in the JSON part. This list contains\nthe files that are being manipulated. This list should have\ncorresponding multiparts in the request that contain the new contents\nof these files.\n\nIf a filename in the `files` list does not have a corresponding part,\nit will be deleted from the snippet, as shown below:\n\n PUT /2.0/snippets/evzijst/kypj HTTP/1.1\n Content-Length: 188\n Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"\n MIME-Version: 1.0\n\n --===============1438169132528273974==\n Content-Type: application/json; charset=\"utf-8\"\n MIME-Version: 1.0\n Content-ID: snippet\n\n {\n \"files\": {\n \"image.png\": {}\n }\n }\n\n --===============1438169132528273974==--\n\nTo simulate a rename, delete a file and add the same file under\nanother name:\n\n PUT /2.0/snippets/evzijst/kypj HTTP/1.1\n Content-Length: 212\n Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"\n MIME-Version: 1.0\n\n --===============1438169132528273974==\n Content-Type: application/json; charset=\"utf-8\"\n MIME-Version: 1.0\n Content-ID: snippet\n\n {\n \"files\": {\n \"foo.txt\": {},\n \"bar.txt\": {}\n }\n }\n\n --===============1438169132528273974==\n Content-Type: text/plain; charset=\"us-ascii\"\n MIME-Version: 1.0\n Content-Transfer-Encoding: 7bit\n Content-ID: \"bar.txt\"\n Content-Disposition: attachment; filename=\"bar.txt\"\n\n foo\n\n --===============1438169132528273974==--\n\n\nmultipart/form-data\n-----------------\n\nAgain, one can also use `multipart/form-data` to manipulate file\ncontents and meta data atomically.\n\n $ curl -X PUT http://localhost:12345/2.0/snippets/evzijst/kypj -F title=\"My updated snippet\" -F file=@foo.txt\n\n PUT /2.0/snippets/evzijst/kypj HTTP/1.1\n Content-Length: 351\n Content-Type: multipart/form-data; boundary=----------------------------63a4b224c59f\n\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"file\"; filename=\"foo.txt\"\n Content-Type: text/plain\n\n foo\n\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"title\"\n\n My updated snippet\n ------------------------------63a4b224c59f\n\nTo delete a file, omit its contents while including its name in the\n`files` field:\n\n $ curl -X PUT https://api.bitbucket.org/2.0/snippets/evzijst/kypj -F files=image.png\n\n PUT /2.0/snippets/evzijst/kypj HTTP/1.1\n Content-Length: 149\n Content-Type: multipart/form-data; boundary=----------------------------ef8871065a86\n\n ------------------------------ef8871065a86\n Content-Disposition: form-data; name=\"files\"\n\n image.png\n ------------------------------ef8871065a86--\n\nThe explicit use of the `files` element in `multipart/related` and\n`multipart/form-data` is only required when deleting files.\nThe default mode of operation is for file parts to be processed,\nregardless of whether or not they are listed in `files`, as a\nconvenience to the client." }, "response": [ { "id": "24074232-dfb7-4342-8e03-bc75b44abb33", "name": "The updated snippet object.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-24074232-dfb7-4342-8e03-bc75b44abb33" }, { "id": "585b7d21-0fe0-4360-9722-3665ac909ec0", "name": "If the snippet is private and the request was not authenticated.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-585b7d21-0fe0-4360-9722-3665ac909ec0" }, { "id": "c67249f4-9378-471d-b6a1-55a63dd90690", "name": "If authenticated user does not have permission to update the private snippet.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-c67249f4-9378-471d-b6a1-55a63dd90690" }, { "id": "d786e372-18cc-4f4d-85c1-73101bddcc03", "name": "If the snippet does not exist.", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-d786e372-18cc-4f4d-85c1-73101bddcc03" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-3369bd71-71d8-47d9-b4e3-9dda23e4a969" } ], "id": "cb238ce0-0512-425d-9154-4aa8015e963e", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-cb238ce0-0512-425d-9154-4aa8015e963e" }, { "name": "List snippets in a workspace", "id": "d8e9e472-f99a-4e3f-8c91-34553a5e5bcf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "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": "082c2c4d-2792-497c-a11f-41fb5f04f8ee", "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\nby the snippet owner and only those that are owned by `{workspace}` are\nreturned." }, "response": [ { "id": "b2a1857f-14c2-481b-ab1b-7a3abae05b4c", "name": "A paginated list of snippets.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"consequat1\": -93507296,\n \"culpab1\": 61074187.16644743\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"labore2ed\": true\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"nisi_4b0\": -500386,\n \"veniam_9\": 67834819.10733831,\n \"est3b\": -3772464\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-b2a1857f-14c2-481b-ab1b-7a3abae05b4c" }, { "id": "3794ae92-ccad-4d07-b5fb-e7d0a7294e6b", "name": "If the user does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-3794ae92-ccad-4d07-b5fb-e7d0a7294e6b" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-d8e9e472-f99a-4e3f-8c91-34553a5e5bcf" }, { "name": "Create a snippet for a workspace", "id": "d9f08e1a-b943-44aa-89a0-f86a9cd382bc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets/:workspace", "host": [ "{{baseUrl}}" ], "path": [ "snippets", ":workspace" ], "variable": [ { "id": "c91e2a51-a2c2-4f01-b9d0-fd19628ab11a", "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\ncreated under the workspace specified in the path parameter\n`{workspace}`." }, "response": [ { "id": "d0d5a754-4017-4266-8353-2ff2bc6b1a17", "name": "The newly created snippet object.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-d0d5a754-4017-4266-8353-2ff2bc6b1a17" }, { "id": "50deae65-706f-4aaf-89a0-d5794419bfc5", "name": "If the request was not authenticated", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-50deae65-706f-4aaf-89a0-d5794419bfc5" }, { "id": "469d03c5-e1c0-47b2-887d-3eef6b2bfd61", "name": "If the authenticated user does not have permission to create snippets in the specified workspace.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "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 \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-469d03c5-e1c0-47b2-887d-3eef6b2bfd61" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-d9f08e1a-b943-44aa-89a0-f86a9cd382bc" } ], "id": "7b6f90df-e8ce-4acb-9ebc-8aff232f3cdb", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7b6f90df-e8ce-4acb-9ebc-8aff232f3cdb" }, { "name": "List snippets", "id": "7527e03e-547a-402f-8914-44c971bee2ee", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/snippets?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ] }, "description": "**This endpoint is deprecated. Please use the\n[workspace scoped alternative](/cloud/bitbucket/rest/api-group-snippets/#api-snippets-workspace-get).**\n\nReturns all snippets. Like pull requests, repositories and workspaces, the\nfull set of snippets is defined by what the current user has access to.\n\nThis includes all snippets owned by any of the workspaces the user is a member of,\nor snippets by other users that the current user is either watching or has collaborated\non (for instance by commenting on it).\n\nTo limit the set of returned snippets, apply the\n`?role=[owner|contributor|member]` query parameter where the roles are\ndefined as follows:\n\n* `owner`: all snippets owned by the current user\n* `contributor`: all snippets owned by, or watched by the current user\n* `member`: created in a workspaces or watched by the current user\n\nWhen no role is specified, all public snippets are returned, as well as all\nprivately owned snippets watched or commented on.\n\nThe returned response is a normal paginated JSON list. This endpoint\nonly supports `application/json` responses and no\n`multipart/form-data` or `multipart/related`. As a result, it is not\npossible to include the file contents." }, "response": [ { "id": "c7148814-cca6-4121-ba94-83156ece7e6e", "name": "A paginated list of snippets.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/snippets?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ] } }, "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"consequat1\": -93507296,\n \"culpab1\": 61074187.16644743\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"labore2ed\": true\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"nisi_4b0\": -500386,\n \"veniam_9\": 67834819.10733831,\n \"est3b\": -3772464\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-c7148814-cca6-4121-ba94-83156ece7e6e" }, { "id": "a402a503-7e80-4352-85cb-0f9a14e6c482", "name": "If the snippet does not exist.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/snippets?role=member", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ], "query": [ { "description": "Filter down the result based on the authenticated user's role (`owner`, `contributor`, or `member`).", "key": "role", "value": "member" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-a402a503-7e80-4352-85cb-0f9a14e6c482" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7527e03e-547a-402f-8914-44c971bee2ee" }, { "name": "Create a snippet", "id": "9fe525a7-e738-42bb-9a23-6e190bad7220", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "repository repository:write repository:admin repository:delete project project:admin email account account:write team team:write pipeline pipeline:write pipeline:variable runner runner:write test test:write pullrequest pullrequest:write webhook issue issue:write snippet snippet:write wiki", "type": "string" }, { "key": "accessTokenUrl", "value": "https://bitbucket.org/site/oauth2/access_token", "type": "string" }, { "key": "authUrl", "value": "https://bitbucket.org/site/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ] }, "description": "Creates a new snippet under the authenticated user's account.\n\nSnippets can contain multiple files. Both text and binary files are\nsupported.\n\nThe simplest way to create a new snippet from a local file:\n\n $ curl -u username:password -X POST https://api.bitbucket.org/2.0/snippets -F file=@image.png\n\nCreating snippets through curl has a few limitations and so let's look\nat a more complicated scenario.\n\nSnippets are created with a multipart POST. Both `multipart/form-data`\nand `multipart/related` are supported. Both allow the creation of\nsnippets with both meta data (title, etc), as well as multiple text\nand binary files.\n\nThe main difference is that `multipart/related` can use rich encoding\nfor the meta data (currently JSON).\n\n\nmultipart/related (RFC-2387)\n----------------------------\n\nThis is the most advanced and efficient way to create a paste.\n\n POST /2.0/snippets/evzijst HTTP/1.1\n Content-Length: 1188\n Content-Type: multipart/related; start=\"snippet\"; boundary=\"===============1438169132528273974==\"\n MIME-Version: 1.0\n\n --===============1438169132528273974==\n Content-Type: application/json; charset=\"utf-8\"\n MIME-Version: 1.0\n Content-ID: snippet\n\n {\n \"title\": \"My snippet\",\n \"is_private\": true,\n \"scm\": \"git\",\n \"files\": {\n \"foo.txt\": {},\n \"image.png\": {}\n }\n }\n\n --===============1438169132528273974==\n Content-Type: text/plain; charset=\"us-ascii\"\n MIME-Version: 1.0\n Content-Transfer-Encoding: 7bit\n Content-ID: \"foo.txt\"\n Content-Disposition: attachment; filename=\"foo.txt\"\n\n foo\n\n --===============1438169132528273974==\n Content-Type: image/png\n MIME-Version: 1.0\n Content-Transfer-Encoding: base64\n Content-ID: \"image.png\"\n Content-Disposition: attachment; filename=\"image.png\"\n\n iVBORw0KGgoAAAANSUhEUgAAABQAAAAoCAYAAAD+MdrbAAABD0lEQVR4Ae3VMUoDQRTG8ccUaW2m\n TKONFxArJYJamCvkCnZTaa+VnQdJSBFl2SMsLFrEWNjZBZs0JgiL/+KrhhVmJRbCLPx4O+/DT2TB\n cbblJxf+UWFVVRNsEGAtgvJxnLm2H+A5RQ93uIl+3632PZyl/skjfOn9Gvdwmlcw5aPUwimG+NT5\n EnNN036IaZePUuIcK533NVfal7/5yjWeot2z9ta1cAczHEf7I+3J0ws9Cgx0fsOFpmlfwKcWPuBQ\n 73Oc4FHzBaZ8llq4q1mr5B2mOUCt815qYR8eB1hG2VJ7j35q4RofaH7IG+Xrf/PfJhfmwtfFYoIN\n AqxFUD6OMxcvkO+UfKfkOyXfKdsv/AYCHMLVkHAFWgAAAABJRU5ErkJggg==\n --===============1438169132528273974==--\n\nThe request contains multiple parts and is structured as follows.\n\nThe first part is the JSON document that describes the snippet's\nproperties or meta data. It either has to be the first part, or the\nrequest's `Content-Type` header must contain the `start` parameter to\npoint to it.\n\nThe remaining parts are the files of which there can be zero or more.\nEach file part should contain the `Content-ID` MIME header through\nwhich the JSON meta data's `files` element addresses it. The value\nshould be the name of the file.\n\n`Content-Disposition` is an optional MIME header. The header's\noptional `filename` parameter can be used to specify the file name\nthat Bitbucket should use when writing the file to disk. When present,\n`filename` takes precedence over the value of `Content-ID`.\n\nWhen the JSON body omits the `files` element, the remaining parts are\nnot ignored. Instead, each file is added to the new snippet as if its\nname was explicitly linked (the use of the `files` elements is\nmandatory for some operations like deleting or renaming files).\n\n\nmultipart/form-data\n-------------------\n\nThe use of JSON for the snippet's meta data is optional. Meta data can\nalso be supplied as regular form fields in a more conventional\n`multipart/form-data` request:\n\n $ curl -X POST -u credentials https://api.bitbucket.org/2.0/snippets -F title=\"My snippet\" -F file=@foo.txt -F file=@image.png\n\n POST /2.0/snippets HTTP/1.1\n Content-Length: 951\n Content-Type: multipart/form-data; boundary=----------------------------63a4b224c59f\n\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"file\"; filename=\"foo.txt\"\n Content-Type: text/plain\n\n foo\n\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"file\"; filename=\"image.png\"\n Content-Type: application/octet-stream\n\n ?PNG\n\n IHDR?1??I.....\n ------------------------------63a4b224c59f\n Content-Disposition: form-data; name=\"title\"\n\n My snippet\n ------------------------------63a4b224c59f--\n\nHere the meta data properties are included as flat, top-level form\nfields. The file attachments use the `file` field name. To attach\nmultiple files, simply repeat the field.\n\nThe advantage of `multipart/form-data` over `multipart/related` is\nthat it can be easier to build clients.\n\nEssentially all properties are optional, `title` and `files` included.\n\n\nSharing and Visibility\n----------------------\n\nSnippets can be either public (visible to anyone on Bitbucket, as well\nas anonymous users), or private (visible only to members of the workspace).\nThis is controlled through the snippet's `is_private` element:\n\n* **is_private=false** -- everyone, including anonymous users can view\n the snippet\n* **is_private=true** -- only workspace members can view the snippet\n\nTo create the snippet under a workspace, just append the workspace ID\nto the URL. See [`/2.0/snippets/{workspace}`](/cloud/bitbucket/rest/api-group-snippets/#api-snippets-workspace-post)." }, "response": [ { "id": "40357d8b-17c0-49a8-8bfe-86bae0eaa38c", "name": "The newly created snippet object.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ] } }, "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 \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-40357d8b-17c0-49a8-8bfe-86bae0eaa38c" }, { "id": "8a69348d-b03d-4ff9-ace9-e98e670f7291", "name": "If the request was not authenticated", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"\",\n \"id\": \"\",\n \"title\": \"\",\n \"scm\": \"git\",\n \"created_on\": \"\",\n \"updated_on\": \"\",\n \"owner\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n },\n \"dolore_11\": -58919505,\n \"sed3\": 32562219.231849983,\n \"exercitation_c6\": \"occaecat\"\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"creator\": {\n \"type\": \"\",\n \"links\": {\n \"avatar\": {\n \"href\": \"\",\n \"name\": \"\"\n }\n },\n \"created_on\": \"\",\n \"display_name\": \"\",\n \"uuid\": \"\"\n },\n \"is_private\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/snippets", "host": [ "{{baseUrl}}" ], "path": [ "snippets" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"error\": {\n \"message\": \"\",\n \"detail\": \"\",\n \"data\": {\n \"eiusmod4\": 48388822,\n \"id_9\": \"in in\"\n }\n }\n}", "createdAt": "2026-07-28T01:14:45.000Z", "updatedAt": "2026-07-28T01:14:45.000Z", "uid": "35240-8a69348d-b03d-4ff9-ace9-e98e670f7291" } ], "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-9fe525a7-e738-42bb-9a23-6e190bad7220" } ], "id": "7913710a-e241-4e5e-848a-ec64fcb5ec33", "createdAt": "2026-07-28T01:14:44.000Z", "updatedAt": "2026-07-28T01:14:44.000Z", "uid": "35240-7913710a-e241-4e5e-848a-ec64fcb5ec33" } ], "variable": [ { "key": "baseUrl", "value": "https://api.bitbucket.org/2.0" } ] }