Atlassian

Atlassian Snippets API

The Snippets API from Atlassian — 14 operation(s) for snippets.

Documentation GitHub OpenAPI

Operations 25

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /snippets List snippets I can access · Atlassian List Snippets #

Ask an LLM

“How do I see every Bitbucket snippet I have access to across my workspaces?”

“Can I narrow my snippet list to only the ones I own or contributed to?”

Tell an agent

List all the snippets I can see.

List my snippets where my role is {role}.

POST /snippets Create a snippet under my account · Atlassian Create A Snippet #

Ask an LLM

“How do I create a new code snippet under my own Bitbucket account?”

“Can a personal snippet hold several files and be marked private?”

Tell an agent

Create a private snippet in my personal account titled {title}.

Make a new snippet on my own account called {title} with privacy set to {is_private}.

GET /snippets/{workspace} List snippets owned by a workspace · Atlassian List Snippets In A Workspace #

Ask an LLM

“Which snippets does a specific workspace own?”

“Can I filter a workspace's snippets by my role in them?”

Tell an agent

List the snippets owned by workspace {workspace}.

Show snippets in {workspace} where I am {role}.

POST /snippets/{workspace} Create a snippet in a workspace · Atlassian Create A Snippet For A Workspace #

Ask an LLM

“How do I create a snippet that belongs to a team workspace rather than my account?”

“What do I need to add a new shared snippet to a workspace?”

Tell an agent

Create a snippet titled {title} in workspace {workspace}.

Add a new workspace snippet to {workspace}.

DELETE /snippets/{workspace}/{encoded_id} Delete a snippet · Atlassian Delete A Snippet #

Ask an LLM

“How do I permanently delete a snippet regardless of its revision?”

“What happens when I remove a snippet from a workspace?”

Tell an agent destructive · confirm first

Delete snippet {encoded_id} from workspace {workspace}.

Remove the snippet {encoded_id} entirely.

GET /snippets/{workspace}/{encoded_id} Get a snippet's current version · Atlassian Get A Snippet #

Ask an LLM

“How do I fetch the current contents and metadata of one snippet?”

“Can I retrieve a snippet as multipart to get its files in one response?”

Tell an agent

Get snippet {encoded_id} in workspace {workspace}.

Show me the latest version of snippet {encoded_id}.

PUT /snippets/{workspace}/{encoded_id} Update a snippet's title or files · Atlassian Update A Snippet #

Ask an LLM

“How do I rename a snippet or add and remove its files?”

“Do properties I leave out stay unchanged when I update a snippet?”

Tell an agent

Update snippet {encoded_id} in {workspace} with my new files.

Change the title of the current snippet {encoded_id}.

GET /snippets/{workspace}/{encoded_id}/comments List comments on a snippet · Atlassian List Comments On A Snippet #

Ask an LLM

“How do I read all the comments people left on a snippet?”

“What order are snippet comments returned in by default?”

Tell an agent

List the comments on snippet {encoded_id} in {workspace}.

Show the discussion on snippet {encoded_id}.

POST /snippets/{workspace}/{encoded_id}/comments Comment on a snippet · Atlassian Create A Comment On A Snippet #

Ask an LLM

“How do I post a comment on someone's snippet?”

“Can I reply in a thread to an existing snippet comment?”

Tell an agent

Add a comment to snippet {encoded_id} in {workspace}.

Post a new comment on snippet {encoded_id}.

DELETE /snippets/{workspace}/{encoded_id}/comments/{comment_id} Delete a snippet comment · Atlassian Delete A Comment On A Snippet #

Ask an LLM

“How do I remove a comment from a snippet?”

“Can a workspace admin delete someone else's snippet comment?”

Tell an agent destructive · confirm first

Delete comment {comment_id} from snippet {encoded_id}.

Remove snippet comment {comment_id} in workspace {workspace}.

GET /snippets/{workspace}/{encoded_id}/comments/{comment_id} Get one snippet comment · Atlassian Get A Comment On A Snippet #

Ask an LLM

“How do I look up a single comment on a snippet by its id?”

“Can I fetch just one snippet comment instead of the whole thread?”

Tell an agent

Get comment {comment_id} on snippet {encoded_id}.

Show snippet comment {comment_id} in workspace {workspace}.

PUT /snippets/{workspace}/{encoded_id}/comments/{comment_id} Edit a snippet comment · Atlassian Update A Comment On A Snippet #

Ask an LLM

“How do I edit a comment I left on a snippet?”

“Who is allowed to change a snippet comment after posting?”

Tell an agent

Edit my comment {comment_id} on snippet {encoded_id}.

Update snippet comment {comment_id} in {workspace} with new text.

GET /snippets/{workspace}/{encoded_id}/commits List a snippet's commit history · Atlassian List Snippet Changes #

Ask an LLM

“How do I see the history of changes made to a snippet?”

“What commits have been made on this snippet over time?”

Tell an agent

List the commits on snippet {encoded_id} in {workspace}.

Show the change history of snippet {encoded_id}.

GET /snippets/{workspace}/{encoded_id}/commits/{revision} Get one commit made to a snippet · Atlassian Get A Previous Snippet Change #

Ask an LLM

“How do I inspect a single past commit on a snippet?”

“What changed in one specific snippet commit?”

Tell an agent

Get commit {revision} of snippet {encoded_id}.

Show snippet change {revision} in workspace {workspace}.

GET /snippets/{workspace}/{encoded_id}/files/{path} Download a snippet file at its latest version · Atlassian Get A Snippet S Raw File At Head #

Ask an LLM

“How do I grab the raw latest contents of a file in a snippet without fetching the snippet first?”

“Is there a shortcut to a snippet file's current raw text?”

Tell an agent

Download the latest {path} from snippet {encoded_id}.

Get the current raw file {path} in snippet {encoded_id} of {workspace}.

DELETE /snippets/{workspace}/{encoded_id}/watch Stop watching a snippet · Atlassian Stop Watching A Snippet #

Ask an LLM

“How do I unsubscribe from a snippet I'm watching?”

“Can I stop getting updates about a snippet?”

Tell an agent destructive · confirm first

Stop watching snippet {encoded_id}.

Unfollow snippet {encoded_id} in workspace {workspace}.

GET /snippets/{workspace}/{encoded_id}/watch Check if I watch a snippet · Atlassian Check If The Current User Is Watching A Snippet #

Ask an LLM

“Am I currently watching this snippet?”

“How can I tell whether I'm subscribed to updates on a snippet?”

Tell an agent

Check whether I'm watching snippet {encoded_id}.

Tell me if I follow snippet {encoded_id} in {workspace}.

PUT /snippets/{workspace}/{encoded_id}/watch Start watching a snippet · Atlassian Watch A Snippet #

Ask an LLM

“How do I subscribe to updates on a snippet?”

“Can I follow a snippet so I get notified about it?”

Tell an agent

Watch snippet {encoded_id} in {workspace}.

Start following snippet {encoded_id}.

GET /snippets/{workspace}/{encoded_id}/watchers List a snippet's watchers · Atlassian List Users Watching A Snippet #

Ask an LLM

“Who is watching this snippet?”

“Which users follow a given snippet?”

Tell an agent

List the users watching snippet {encoded_id}.

Show the watchers of snippet {encoded_id} in {workspace}.

DELETE /snippets/{workspace}/{encoded_id}/{node_id} Delete a snippet only if at a revision · Atlassian Delete A Previous Revision Of A Snippet #

Ask an LLM

“How do I delete a snippet only when nobody has changed it since a given commit?”

“Why does deleting a snippet via an older commit URL fail?”

Tell an agent destructive · confirm first

Delete snippet {encoded_id} only if its latest revision is {node_id}.

Remove snippet {encoded_id} in {workspace} pinned to revision {node_id}.

GET /snippets/{workspace}/{encoded_id}/{node_id} Get a snippet as of an older revision · Atlassian Get A Previous Revision Of A Snippet #

Ask an LLM

“How do I see what a snippet looked like at an earlier revision?”

“Can I retrieve an old version of a snippet's files?”

Tell an agent

Get snippet {encoded_id} as it was at revision {node_id}.

Show the {node_id} version of snippet {encoded_id} in {workspace}.

PUT /snippets/{workspace}/{encoded_id}/{node_id} Update a snippet pinned to a revision · Atlassian Update A Previous Revision Of A Snippet #

Ask an LLM

“How do I update a snippet only if it is still at the revision I last saw?”

“Why does updating an older snippet revision return a 405?”

Tell an agent

Update snippet {encoded_id} at revision {node_id}, failing if it has moved on.

Save changes to snippet {encoded_id} in {workspace} against tip revision {node_id}.

GET /snippets/{workspace}/{encoded_id}/{node_id}/files/{path} Download a snippet file at a revision · Atlassian Get A Snippet S Raw File #

Ask an LLM

“How do I download a snippet file as it was at a specific revision?”

“What content type comes back when I fetch a raw file from an older snippet version?”

Tell an agent

Download file {path} from snippet {encoded_id} at revision {node_id}.

Get the raw {path} of snippet {encoded_id} in {workspace} at version {node_id}.

GET /snippets/{workspace}/{encoded_id}/{revision}/diff Get a snippet commit's diff · Atlassian Get Snippet Changes Between Versions #

Ask an LLM

“How do I see the diff a snippet commit introduced against its parent?”

“Can I limit a snippet diff to just one file?”

Tell an agent

Show the diff for snippet {encoded_id} in {workspace} at revision {revision}.

Diff only file {path} in snippet {encoded_id} at {revision}.

GET /snippets/{workspace}/{encoded_id}/{revision}/patch Get a snippet commit as a patch · Atlassian Get Snippet Patch Between Versions #

Ask an LLM

“How do I get a git-style patch with author and message for a snippet commit?”

“Can I export a snippet commit as a patch that includes its commit header?”

Tell an agent

Get the patch for snippet {encoded_id} at revision {revision}.

Export revision {revision} of snippet {encoded_id} in {workspace} as a patch.

Documentation

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-addon/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-webhooks/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-pullrequests/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-repositories/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-snippets/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-workspaces/

https://developer.atlassian.com/cloud/bitbucket/rest/api-group-users/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-analytics/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-audit/

https://developer.atlassian.com/cloud/confluence/connect-modules/

https://developer.atlassian.com/cloud/confluence/rest/v2/intro/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-body/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-states/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-group/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-inline-tasks

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content-labels/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-long-running-task/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-relation/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-search/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-settings/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-space/

https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-template/

https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-user/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-announcement-banner/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-values--apps-/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-app-openapi

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-application-roles/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/

https://developer.atlassian.com/server/framework/atlassian-sdk/audit/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-avatars/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-classification-levels/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-components/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-settings/

https://developer.atlassian.com/cloud/jira/platform/getting-started-with-connect/

https://developer.atlassian.com/cloud/jira/platform/connect-api-migration/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-service-registry/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-dashboards/

https://developer.atlassian.com/cloud/jira/platform/data-security-policy-developer-guide/

https://developer.atlassian.com/platform/forge/events-reference/jira/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-expressions/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-field-configurations/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-filters/

https://developer.atlassian.com/cloud/jira/platform/forge/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-groups/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-group-and-user-picker/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-groups/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issues/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-links/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-security-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-types/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-type-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-type-screen-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-labels/

https://developer.atlassian.com/platform/marketplace/license-api-for-cloud-apps/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-license-metrics/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-permissions/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-myself/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-notification-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-permission-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-priorities/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-categories/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-key-and-name-validation/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-resolutions/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-project-roles/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-screens/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-screen-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-security-level/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-server-info/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-statuses/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-status-categories/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-ui-modifications--apps-/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-avatars/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-versions/

https://developer.atlassian.com/server/jira/platform/webhooks/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/

https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-workflow-schemes/

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/

https://developer.atlassian.com/cloud/admin/organization/rest/

https://developer.atlassian.com/cloud/admin/user-management/rest/

https://developer.atlassian.com/cloud/admin/user-provisioning/rest/

Specifications

https://artifacts.apis.io/atlassian/openapi/atlassian-snippets-api-openapi.yml

Schemas & Data

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-hook-events-paginated_hook_events-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-pull-requests-a_pullrequest_comment_task-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-repositories-account-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-snippets-account-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-teams-account-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-user-account-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-bitbucket-workspaces-account-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-content-body-async-content-body-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-content-states-async-id-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-group-group-array-with-links-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-inline-tasks-task-page-response-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-longtask-long-task-status-with-links-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-search-search-page-response-search-result-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-space-content-state-settings-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-template-blueprint-template-array-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-confluence-user-account-id-email-record-schema.json

https://artifacts.apis.io/atlassian/json-schema/atlassian-admin-domain-page-schema.json

Other Resources

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-hook-events-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-pull-requests-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-repositories-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-snippets-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-teams-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-user-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-bitbucket-workspaces-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-audit-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-content-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-content-body-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-content-states-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-group-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-inline-tasks-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-longtask-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-relation-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-search-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-settings-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-space-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-template-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-confluence-user-context.jsonld

https://artifacts.apis.io/atlassian/json-ld/atlassian-admin-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/atlassian:atlassian-snippets-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Atlassian Snippets API
  version: '2.0'
  contact:
    name: Bitbucket Support
    url: https://support.atlassian.com/bitbucket-cloud/
    email: support@bitbucket.org
  termsOfService: https://www.atlassian.com/legal/customer-agreement
  description: 'Operations tagged Snippets across 2 of this provider''s published API definitions: bitbucket-openapi-original.yml, bitbucket-swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.bitbucket.org/2.0
tags:


# --- truncated at 32 KB (62 KB total) ---
# Full source: https://artifacts.apis.io/atlassian/openapi/atlassian-snippets-api-openapi.yml