How to configure the Working Copy app with an API token

[Phil Shaw]

I use the Working Copy app on iPad and iPhone. I currently use https with App passwords for Git operations. I want to switch to use API tokens for BitBucket. How do I configure Working Copy to use API tokens?

[Ben]

G'day Phil!

Welcome to the Bitbucket Cloud community! :)

In general - the correct process for configuring an API token for GIT operations is as follows:

You'll first need to create the API token and specify the scope - this is mentioned in our deprecation documentation:

1. Click the gear cog icon, select Atlassian Account settings > Security tab > Create and manage API Tokens

2. Click Create API token with scopes and select Bitbucket Cloud

3. If you want to be able to clone/push/pull to the repository - you'll need to tick both read:repository:bitbucket and write:repository:bitbucket - clone only would just be read:repository:bitbucket. More information on scopes can be found in our API scopes documentation.

The format for the remote URL will be one of the two below (depending on your preference):

git clone https://username:APIToken@bitbucket.org/workspaceID/reposlug.git
git clone https://x-bitbucket-api-token-auth:APIToken@bitbucket.org/workspaceID/reposlug.git

You may be able to simply replace your AppPassword with the APIToken instead, since the first example is the same format that would be used when authenticating with AppPassword.

If WorkingCopy does not allow you to customise the remote URL, or, if it doesn't accept the API token - I'd suggest reaching out to their support team for further assistance: support@workingcopy.app

Cheers!

- Ben (Bitbucket Cloud Support)

[Phil Shaw]

OK, thanks Ben, I will contact them. 

Cheers, Phil