Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

REST API accessing files containing special characters in their name or path

File names and paths in REST API endpoints

Bitbucket Server REST API endpoints provide the ability to check details on files and these files may contain some special characters.

For example the following endpoint can be used to retrieved the raw content of a file



What are special characters in the path or the filename?

It could be anything, but the ones we have seen the most are the following:

% (e.g. as part of %20)

- #


What to do about those?

Simply encode them when using the endpoint, for example by using the ASCII Encoding Reference page.

The encodings for the examples above are the following:

%: %25

- #: %23


With an example

If the path to the file is "test%20special#character/", the REST API endpoint can be called in the following way:





Log in or Sign up to comment
AUG Leaders

Atlassian Community Events