{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Try it!","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"],"excludeFiles":[]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"try-it","__idx":0},"children":["Try it!"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After reading all the documentation, you might want to give AI Agent API a try. For that, we have prepared a"," ","demo environment that anyone can access. Authentication is required, but any token"," ","that you pass should work, so no need to get a User or Application key in advance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To show how this environment works, we will use Postman, but you can use any other REST client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The URL where this API can be located is: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://16abf815-424c-413e-b92d-6c6f8fc633cd.remockly.com/intelligence/api"]},". Keep in mind that"," ","for real production environments, the URL typically ends with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/intelligence/api"]}," and not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-create-a-new-http-request","__idx":1},"children":["1. Create a new HTTP Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start by creating a new HTTP Request in Postman (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File > New > HTTP Request"]},"). Make sure that you have"," ","selected a GET operation and paste the URL for the API next to it: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://16abf815-424c-413e-b92d-6c6f8fc633cd.remockly.com/intelligence/api"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mock-step1.a2d6032743d2d7ddaa4c957eac4d54246350eac78464761b5a776d164e8eca88.cfac32e3.png","alt":"Create a new HTTP Request"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-configure-authentication","__idx":2},"children":["2. Configure authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Let's say our User API Key is"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NASDYUmYxMjItNmJJHuNYSdn7FkLThhasdhj89jM2ODVmOio090sadjkdkVnRFV3VVBtZ1jksadb8olJWXMSDHUASDik3UE5j"]},". Go to Postman"," ","and use this key for the Authentication header."," ","Click on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," and select ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer Token"]}," for the Type. For the token, paste the above key."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mock-step2.639caa743ba3d49f625a341eb4629a616b7d47b4c13c2e51e3bdb54dc60b019d.cfac32e3.png","alt":"Configure authentication"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-chat-with-a-specific-celonis-agent","__idx":3},"children":["3. Chat with a specific Celonis Agent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Imagine you want to chat with a Celonis Agent to get some information. This is possible by adding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/conversations"]}," to the URL of the Celonis Agent."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/mock-step22.d735bb953a907f8538cdeb49551976ddfdcc02994f005f57bee97b78a975c5d6.cfac32e3.png","alt":"Chat with a Celonis Agent"},"children":[]}]}]},"headings":[{"value":"Try it!","id":"try-it","depth":1},{"value":"1. Create a new HTTP Request","id":"1-create-a-new-http-request","depth":2},{"value":"2. Configure authentication","id":"2-configure-authentication","depth":2},{"value":"3. Chat with a specific Celonis Agent","id":"3-chat-with-a-specific-celonis-agent","depth":2}],"frontmatter":{"seo":{"title":"Try it!"}},"lastModified":"2026-03-06T16:57:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/process-intelligence-apis/agents-api/api-reference/try-it","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}