Hi, Is there an Atlas API we can interact with? We are already using the APIs of Jira, Confluence and Tempo to automate our workflow so that, when we start a new project: * A new Jira Project is created (this Project will be used to track what needs to be done in this project as well as any other projects related to this client) * A new Customer is created in Tempo * A few predefined Accounts are created in Tempo, linked to this Customer and the Jira Project * A new Epic is created within the Jira Project (the Epic represents the new project we need to work on) * A new Confluence Space is created (this Space will hold this new project's documentation as well as any future projects related to this client) * Also, and not related to Atlassian products:* A Slack channel is created for all discussions related to this client * A Google Drive folder is created for this client and the project So, now that we are giving Atlas a test run, it would be awesome if the Atlas Project could also be created automatically :) Toughts?

nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Can we interact with Atlas API ?

Marc-André Lanciault

Hi,

Is there an Atlas API we can interact with?

We are already using the APIs of Jira, Confluence and Tempo to automate our workflow so that, when we start a new project:

A new Jira Project is created (this Project will be used to track what needs to be done in this project as well as any other projects related to this client)
A new Customer is created in Tempo
A few predefined Accounts are created in Tempo, linked to this Customer and the Jira Project
A new Epic is created within the Jira Project (the Epic represents the new project we need to work on)
A new Confluence Space is created (this Space will hold this new project's documentation as well as any future projects related to this client)
Also, and not related to Atlassian products:
- A Slack channel is created for all discussions related to this client
- A Google Drive folder is created for this client and the project

So, now that we are giving Atlas a test run, it would be awesome if the Atlas Project could also be created automatically

Toughts?

Accepted answers

Nir Nikolaevsky

Hi @Marc-André Lanciault

We don't have an API available yet but we want to support it in the future.

In the meantime when you create a new Epic you can also create and sync an Atlas Project right from the Epic screen.

In the right-side menu you should see a "Status updates" section. Expand it and click on "Create Atlas project". You can sync the Epic's title, date, and labels to this Atlas project. The integration is relatively new and still being rolled out so if you're not seeing it you can get it from our marketplace here. You can learn more about the integration here.

I know it's not automation but hopefully it makes the process a little easier for you and the team.

CleanShot 2023-07-26 at 19.44.53.png

All comments

Nir Nikolaevsky

Hi @Marc-André Lanciault

We don't have an API available yet but we want to support it in the future.

In the meantime when you create a new Epic you can also create and sync an Atlas Project right from the Epic screen.

I know it's not automation but hopefully it makes the process a little easier for you and the team.

CleanShot 2023-07-26 at 19.44.53.png

Marc-André Lanciault

Thanks for the answer Nir

Nate Whitehead_kwg5sp

Is this still the case?

Sean Blezard

I was thinking the same question.

Kurt Anderson_de1r9i

+1 from me. We can't sync all properties and would like to automate an org chart without some way to access user data I can't.

Nir Nikolaevsky

Hi all, no new update I can share about an Atlas API at this stage.

Could you list your use cases for an Atlas API as a reply? Perhaps I can offer a workaround or at the very least capture your use cases and share them with the team.

Dan W_kamf5a

Use Case - Being able to send an update when a linked Story/Epic/Bug transitions to a new status

Alejandro Álvarez_c0rguc

If we had a field at KR level we could update that field with external data to understand our KR achievements. Example, the KR is 1'2 M revenue, but the revenue data is located outside Atlas. Would be super important to show the current revenue in Atlas compared to the KR revenue, to understand the achievement of it.

Maximiliano Suarez

API use case: integrate in Confluence (or export) a report of Atlas projects, filtered by tags, with the last update of the project and the following information :

Update content
Date of the update

Nate Whitehead_kwg5sp

Is there any update on timing for Atlas API access? I have a number of use cases (e.g. some automation related, some to support scripts)

Marc-André Lanciault

Hi @Nir Nikolaevsky

Any update on this by any chance ?

Thanks!

Kimmiko James

Hi @Marc-André Lanciault I'll be picking up this project so progress can be made! I'll be reaching out soon with a scheduling link so I can better understand your use case needs for Atlas APIs (especially for Goals and Projects)!

Andy Johnston_s7rvun

Hi @Kimmiko James - I'd love to get involved with this use-case, as we're looking to drop the Atlas product in favour of a customised solution for RAG (because I can't get access to the RAG for reporting for Plans/Roadmaps/SteerCo reports etc.

Kimmiko James

Here's the Calendly link for those interested! Let me know if you have any questions :-)

https://calendly.com/kjames2-atlassian/product-research

Christian Voigt

Finally there is a feature request for a GOALS API - see: https://jira.atlassian.com/browse/ATLAS-140

Please vote for the issue and leave a comment regarding your usecase / need for the API

Miguel Puig

Is the Atlas API still not available?

Miguel Puig

Yes — you can query Atlas (Atlassian Home) Projects today via GraphQL

There's still no official REST API for Atlas Goals/Projects (vote/track it — ATLAS-140):
https://jira.atlassian.com/browse/ATLAS-140

But the Atlas frontend runs on an internal GraphQL gateway you can call directly with a standard API token. It's undocumented and unsupported, so Atlassian can change it without notice — fine for reporting/exports on your own tenant, but don't build anything critical on it.

WHAT YOU NEED

An API token:
https://id.atlassian.com/manage-profile/security/api-tokens

Your cloud ID — run this and take the cloudId value:
curl https://your-site.atlassian.net/_edge/tenant_info

A Basic auth header (generate locally so your token isn't pasted anywhere):
echo -n 'you@example.com:YOUR_API_TOKEN' | base64

LIST ALL PROJECTS

Put the base64 value after "Basic " and your cloud ID in the container ARI. (Paste this into a code block.)

curl --location 'https://your-site.atlassian.net/gateway/api/graphql' --header 'Content-Type: application/json' --header 'Authorization: Basic YOUR_BASE64_HEADER' --data '{"query":"query ProjectsSearch { projects_search(containerId: "ari:cloud:townsquare::site/YOUR_CLOUD_ID", searchString: "", first: 100) { pageInfo { hasNextPage endCursor } edges { node { key name url state { value label } owner { name } dueDate { dateRange { end } } creationDate } } } }"}'

Paginate: pass the returned endCursor back as after: "..." until hasNextPage is false.
Filter: searchString takes TQL, e.g. state = on_track or name LIKE "Website". Empty string returns everything.

DISCOVER OTHER FIELDS

Nothing is documented, so introspect the schema to find valid fields (this is how I learned the field is state, not status):

curl --location 'https://your-site.atlassian.net/gateway/api/graphql' --header 'Content-Type: application/json' --header 'Authorization: Basic YOUR_BASE64_HEADER' --data '{"query":"query Introspect { __type(name: "TownsquareProject") { fields { name } } }"}'

Goals work the same way — introspect TownsquareGoal.

Hope this helps, and still worth voting on ATLAS-140:
https://jira.atlassian.com/browse/ATLAS-140