Bitbucket app connection docs

docs/api-reference/endpoints/app-connections/bitbucket/available.mdx

@@ -0,0 +1,4 @@
+---
+title: "Available"
+openapi: "GET /api/v1/app-connections/bitbucket/available"
+---

docs/api-reference/endpoints/app-connections/bitbucket/create.mdx

@@ -0,0 +1,8 @@
+---
+title: "Create"
+openapi: "POST /api/v1/app-connections/bitbucket"
+---
+
+<Note>
+    Check out the configuration docs for [Bitbucket Connections](/integrations/app-connections/bitbucket) to learn how to obtain the required credentials.
+</Note>

docs/api-reference/endpoints/app-connections/bitbucket/delete.mdx

@@ -0,0 +1,4 @@
+---
+title: "Delete"
+openapi: "DELETE /api/v1/app-connections/bitbucket/{connectionId}"
+---

docs/api-reference/endpoints/app-connections/bitbucket/get-by-id.mdx

@@ -0,0 +1,4 @@
+---
+title: "Get by ID"
+openapi: "GET /api/v1/app-connections/bitbucket/{connectionId}"
+---

docs/api-reference/endpoints/app-connections/bitbucket/get-by-name.mdx

@@ -0,0 +1,4 @@
+---
+title: "Get by Name"
+openapi: "GET /api/v1/app-connections/bitbucket/connection-name/{connectionName}"
+---

docs/api-reference/endpoints/app-connections/bitbucket/list.mdx

@@ -0,0 +1,4 @@
+---
+title: "List"
+openapi: "GET /api/v1/app-connections/bitbucket"
+---

docs/api-reference/endpoints/app-connections/bitbucket/update.mdx

@@ -0,0 +1,8 @@
+---
+title: "Update"
+openapi: "PATCH /api/v1/app-connections/bitbucket/{connectionId}"
+---
+
+<Note>
+    Check out the configuration docs for [Bitbucket Connections](/integrations/app-connections/bitbucket) to learn how to obtain the required credentials.
+</Note>

docs/docs.json

@@ -470,6 +470,7 @@
                   "integrations/app-connections/azure-client-secrets",
                   "integrations/app-connections/azure-devops",
                   "integrations/app-connections/azure-key-vault",
+                  "integrations/app-connections/bitbucket",
                   "integrations/app-connections/camunda",
                   "integrations/app-connections/cloudflare",
                   "integrations/app-connections/databricks",
@@ -1276,6 +1277,18 @@
                       "api-reference/endpoints/app-connections/azure-key-vault/delete"
                     ]
                   },
+                  {
+                    "group": "Bitbucket",
+                    "pages": [
+                      "api-reference/endpoints/app-connections/bitbucket/list",
+                      "api-reference/endpoints/app-connections/bitbucket/available",
+                      "api-reference/endpoints/app-connections/bitbucket/get-by-id",
+                      "api-reference/endpoints/app-connections/bitbucket/get-by-name",
+                      "api-reference/endpoints/app-connections/bitbucket/create",
+                      "api-reference/endpoints/app-connections/bitbucket/update",
+                      "api-reference/endpoints/app-connections/bitbucket/delete"
+                    ]
+                  },
                   {
                     "group": "Camunda",
                     "pages": [

docs/integrations/app-connections/bitbucket.mdx

@@ -0,0 +1,124 @@
+---
+title: "Bitbucket Connection"
+description: "Learn how to configure a Bitbucket Connection for Infisical."
+---
+
+Infisical supports the use of [API Tokens](https://support.atlassian.com/bitbucket-cloud/docs/api-tokens/) to connect with Bitbucket.
+
+## Create Bitbucket Access Token
+
+<Steps>
+    <Step title="Create API Token">
+        Go to [Account API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens) and click 'Create API token with scopes'.
+
+        ![Create API Token](/images/app-connections/bitbucket/step-1.png)
+    </Step>
+    <Step title="Set Name and Expiry">
+        Set the name and expiration date of the token, then click 'Next'. Keep in mind that you'll need to manually replace the token after it expires.
+
+        ![Set Name and Expiry](/images/app-connections/bitbucket/step-2.png)
+    </Step>
+    <Step title="Select 'Bitbucket'">
+        Select 'Bitbucket' and then click 'Next'.
+
+        ![Select Bitbucket](/images/app-connections/bitbucket/step-3.png)
+    </Step>
+    <Step title="Configure Permissions">
+        Configure permissions according to your app's use case:
+
+        <Tabs>
+            <Tab title="Secret Scanning">
+                ```
+                read:workspace:bitbucket
+                read:user:bitbucket
+                read:webhook:bitbucket
+                write:webhook:bitbucket
+                delete:webhook:bitbucket
+                read:repository:bitbucket
+                ```
+            </Tab>
+        </Tabs>
+
+        Click 'Next'.
+
+        ![Configure Permissions](/images/app-connections/bitbucket/step-4.png)
+    </Step>
+    <Step title="Copy Token">
+        Save the API Token for later steps.
+
+        ![Save Token](/images/app-connections/bitbucket/step-5.png)
+    </Step>
+</Steps>
+
+## Create Bitbucket Connection in Infisical
+
+<Tabs>
+    <Tab title="Infisical UI">
+        <Steps>
+            <Step title="Navigate to App Connections">
+                In your Infisical dashboard, go to **Organization Settings** and select the [**App Connections**](https://app.infisical.com/organization/app-connections) tab.
+
+                ![App Connections Tab](/images/app-connections/general/add-connection.png)
+            </Step>
+            <Step title="Select Bitbucket Connection">
+                Click the 'Add new connection' button and select 'Bitbucket' from the list of available connections.
+            </Step>
+            <Step title="Fill out the Bitbucket Connection Modal">
+                Complete the Bitbucket Connection form by entering:
+                - A descriptive name for the connection
+                - An optional description for future reference
+                - Your Bitbucket email
+                - The API Token from earlier steps
+
+                ![Bitbucket Connection Modal](/images/app-connections/bitbucket/step-6.png)
+            </Step>
+            <Step title="Connection Created">
+                After clicking Create, your **Bitbucket Connection** is established and ready to use with your Infisical projects.
+
+                ![Bitbucket Connection Created](/images/app-connections/bitbucket/step-7.png)
+            </Step>
+        </Steps>
+    </Tab>
+    <Tab title="API">
+        To create a Bitbucket Connection, make an API request to the [Create Bitbucket Connection](/api-reference/endpoints/app-connections/bitbucket/create) API endpoint.
+
+        ### Sample request
+
+        ```bash Request
+        curl    --request POST \
+                --url https://app.infisical.com/api/v1/app-connections/bitbucket \
+                --header 'Content-Type: application/json' \
+                --data '{
+                    "name": "my-bitbucket-connection",
+                    "method": "api-token",
+                    "credentials": {
+                        "email": "[email protected]",
+                        "apiToken": "[PRIVATE TOKEN]"
+                    }
+                }'
+        ```
+
+        ### Sample response
+
+        ```bash Response
+        {
+          "appConnection": {
+              "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
+              "name": "my-bitbucket-connection",
+              "description": null,
+              "version": 1,
+              "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
+              "createdAt": "2025-04-23T19:46:34.831Z",
+              "updatedAt": "2025-04-23T19:46:34.831Z",
+              "isPlatformManagedCredentials": false,
+              "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
+              "app": "bitbucket",
+              "method": "api-token",
+              "credentials": {
+                  "email": "[email protected]"
+              }
+          }
+        }
+        ```
+    </Tab>
+</Tabs>