diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/available.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/available.mdx new file mode 100644 index 000000000..cdaaceff3 --- /dev/null +++ b/docs/api-reference/endpoints/app-connections/bitbucket/available.mdx @@ -0,0 +1,4 @@ +--- +title: "Available" +openapi: "GET /api/v1/app-connections/bitbucket/available" +--- diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/create.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/create.mdx new file mode 100644 index 000000000..70f48aae7 --- /dev/null +++ b/docs/api-reference/endpoints/app-connections/bitbucket/create.mdx @@ -0,0 +1,8 @@ +--- +title: "Create" +openapi: "POST /api/v1/app-connections/bitbucket" +--- + + + Check out the configuration docs for [Bitbucket Connections](/integrations/app-connections/bitbucket) to learn how to obtain the required credentials. + diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/delete.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/delete.mdx new file mode 100644 index 000000000..a61b6bbb1 --- /dev/null +++ b/docs/api-reference/endpoints/app-connections/bitbucket/delete.mdx @@ -0,0 +1,4 @@ +--- +title: "Delete" +openapi: "DELETE /api/v1/app-connections/bitbucket/{connectionId}" +--- diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/get-by-id.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/get-by-id.mdx new file mode 100644 index 000000000..83f7f7521 --- /dev/null +++ b/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}" +--- diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/get-by-name.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/get-by-name.mdx new file mode 100644 index 000000000..f2aa16f40 --- /dev/null +++ b/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}" +--- diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/list.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/list.mdx new file mode 100644 index 000000000..4bc4c4714 --- /dev/null +++ b/docs/api-reference/endpoints/app-connections/bitbucket/list.mdx @@ -0,0 +1,4 @@ +--- +title: "List" +openapi: "GET /api/v1/app-connections/bitbucket" +--- diff --git a/docs/api-reference/endpoints/app-connections/bitbucket/update.mdx b/docs/api-reference/endpoints/app-connections/bitbucket/update.mdx new file mode 100644 index 000000000..289e96681 --- /dev/null +++ b/docs/api-reference/endpoints/app-connections/bitbucket/update.mdx @@ -0,0 +1,8 @@ +--- +title: "Update" +openapi: "PATCH /api/v1/app-connections/bitbucket/{connectionId}" +--- + + + Check out the configuration docs for [Bitbucket Connections](/integrations/app-connections/bitbucket) to learn how to obtain the required credentials. + diff --git a/docs/docs.json b/docs/docs.json index 4e09e6751..3b337fdc6 100644 --- a/docs/docs.json +++ b/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": [ diff --git a/docs/images/app-connections/bitbucket/step-1.png b/docs/images/app-connections/bitbucket/step-1.png new file mode 100644 index 000000000..3b5941e82 Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-1.png differ diff --git a/docs/images/app-connections/bitbucket/step-2.png b/docs/images/app-connections/bitbucket/step-2.png new file mode 100644 index 000000000..91d06eb34 Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-2.png differ diff --git a/docs/images/app-connections/bitbucket/step-3.png b/docs/images/app-connections/bitbucket/step-3.png new file mode 100644 index 000000000..840d86e1b Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-3.png differ diff --git a/docs/images/app-connections/bitbucket/step-4.png b/docs/images/app-connections/bitbucket/step-4.png new file mode 100644 index 000000000..95b4095d8 Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-4.png differ diff --git a/docs/images/app-connections/bitbucket/step-5.png b/docs/images/app-connections/bitbucket/step-5.png new file mode 100644 index 000000000..278446897 Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-5.png differ diff --git a/docs/images/app-connections/bitbucket/step-6.png b/docs/images/app-connections/bitbucket/step-6.png new file mode 100644 index 000000000..cf45c347b Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-6.png differ diff --git a/docs/images/app-connections/bitbucket/step-7.png b/docs/images/app-connections/bitbucket/step-7.png new file mode 100644 index 000000000..4c13a1f61 Binary files /dev/null and b/docs/images/app-connections/bitbucket/step-7.png differ diff --git a/docs/integrations/app-connections/bitbucket.mdx b/docs/integrations/app-connections/bitbucket.mdx new file mode 100644 index 000000000..72035aee3 --- /dev/null +++ b/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 + + + + 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) + + + 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) + + + Select 'Bitbucket' and then click 'Next'. + + ![Select Bitbucket](/images/app-connections/bitbucket/step-3.png) + + + Configure permissions according to your app's use case: + + + + ``` + read:workspace:bitbucket + read:user:bitbucket + read:webhook:bitbucket + write:webhook:bitbucket + delete:webhook:bitbucket + read:repository:bitbucket + ``` + + + + Click 'Next'. + + ![Configure Permissions](/images/app-connections/bitbucket/step-4.png) + + + Save the API Token for later steps. + + ![Save Token](/images/app-connections/bitbucket/step-5.png) + + + +## Create Bitbucket Connection in Infisical + + + + + + 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) + + + Click the 'Add new connection' button and select 'Bitbucket' from the list of available connections. + + + 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) + + + 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) + + + + + 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": "user@example.com", + "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": "user@example.com" + } + } + } + ``` + +