Cloud REST API authentication with API key

Esther Strom

I'm trying to use Postman to access our cloud instance via REST. I clicked the "Run in Postman" button in the API docs, and it did import a collection into Postman. But in the auth, folder, the Create Session request continually returns 401. When I open the notes at the top, there's a link indicating that that particular endpoint was deprecated last year, with a link to this document.

So, if the only endpoint provided in the collection doesn't actually exist anymore, how do I authenticate via Postman using an API token? I think I can add a new request, but what should the endpoint be?

I'd love it if there were a video out there somewhere, but most of what I've found on YouTube is old enough to be out of date.

Marty_yvf6sb

Hi Esther,

I'm not part of the Jira or Confluence team, but I'll see if I can help.

You can still use Postman to test some endpoints (curl is another alternative that is not too much of a pain to learn).

I *think* the key difference is that you need to send an Authorization header with an API token instead of with a user password.  So if you setup an API token in your instance, then you can go to your Postman request and change the 'password' being using in the Authorization header.  I think the header is 'user:api_token'.

I hope that helps!