Chapter 7. API changes in Ansible Automation Platform 2.6


Ansible Automation Platform 2.5 and 2.6 include changes to API endpoints with the addition of platform gateway. Versions 2.5 and 2.6 expose API access to individual services (automation controller, private automation hub, Event-Driven Ansible) to maintain compatibility with existing REST API integrations. This access will be removed in a future release.

These changes impact your organization if you have 2.4 API calls implemented directly with automation controller or private automation hub, or if you are integrating directly with automation controller or private automation hub hosts. You can use API endpoints exposed through the platform gateway for all Ansible Automation Platform services starting with Ansible Automation Platform 2.5. Moving integrations to API endpoints exposed through the platform gateway that your integrations are not disrupted when direct service API access is removed in a future Ansible Automation Platform release.

This section highlights the changed APIs between 2.4 and 2.5 or 2.6. For detailed API reference information, see the following sources:

  • For platform gateway APIs, see the browsable API at https://<gateway server name>/api/gateway/v1.
  • For automation controller APIs, see the browsable API at https://<gateway server name>/api/controller/v2.
  • For automation hub APIs, see Automation Hub API in API Catalog and Documentation to reference the 2.4 automation hub API.
  • For Event-Driven Ansible, see the browsable API at https://<gateway server name>/api/eda/v1.

7.1. General changes

In Ansible Automation Platform 2.5 and later, API endpoints across components changed with the addition of platform gateway.

Expand
Component2.4 and earlier endpoints start with…2.5 and later endpoints start with…Notes

Automation controller

/api/v2/

/api/controller/v2/

 

Automation hub

/api/automation-hub

/api/galaxy/v1

This is the default path, but this path can be changed. For example: https://<local_hub_URL>/api/

Platform gateway

Not applicable

/api/gateway/v1/

 

Event-Driven Ansible

Not applicable

/api/eda/v1/

 

7.2. Specific API changes

Specific API mappings for functionality that was centralized through the platform gateway are listed in the following table.

Expand
Component2.4 and earlier endpoints start with…2.5 and 2.6 API endpointsAction needed and notes

Automation controller

/api/v2/o

/api/gateway/v1/tokens/

Token authentication has moved to the platform gateway.

The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release.

Automation controller

/api/v2/organizations

/api/gateway/v1/organizations/

Moved to the platform gateway.

The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release.

Automation controller

/api/v2/teams

/api/gateway/v1/teams/

Moved to the platform gateway.

The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release.

Automation controller

/api/v2/users

/api/gateway/v1/users/

Moved to the platform gateway.

The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release.

Automation controller

/api/v2/roles

/api/gateway/v1/role_definitions/

Moved to the platform gateway. This is a list of roles. In Ansible Automation Platform 2.6, this is a list of roles which can apply to all services, and includes custom roles.

The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release.

Automation controller

  • /api/v2/roles/{id}/teams/
  • /api/gateway/v1/role_definitions/
  • /api/gateway/v1/role_team_assignments/
  • /api/gateway/v1/role_user_assignments/

A POST request gives a user a role to a resource. This is how to give user permissions.

The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release.

Automation controller

The following roles list:

  • /api/v2/teams/{id}/roles/
  • /api/v2/users/{id}/roles/
  • /api/gateway/v1/role_team_assignments/?team={id}
  • /api/gateway/v1/role_user_assignments/?user={id}

List user and team permissions, and give new permissions.

The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release.

Automation controller

The following object roles list:

/api/v2/{model_name}/{id}/object_roles/

Example: /api/v2/credentials/42/

/api/gateway/v1/role_user_assignments/?content_type__api_slug={model_api_slug}&object_id={id}

Example: /api/gateway/v1/role_user_assignments/?content_type__api_slug=awx.credential&object_id=42

List the roles that apply to a resource.

Automation controller

The following resource access list:

/api/v2/{model_name}/{id}/access_list/

Example: /api/v2/credentials/42/access_list/

Replacement in 2.6: /api/gateway/v1/role_user_access/{model_api_slug}/{id}/

Example: /api/gateway/v1/role_user_access/awx.credential/42/

List the users who have access to a resource.

Automation hub

/api/v3/login/keycloak

/api/gateway/social/complete/<UID>/

Moved to the platform gateway.

Automation hub

/api/v3/auth/token

/api/gateway/v1/tokens/

Token authentication used for pulling collections will migrate to the platform gateway tokens.

Event-Driven Ansible

N/A

/api/gateway/v1/organizations/

No action needed, as upgrades from 2.4 are not supported.

Event-Driven Ansible

N/A

/api/gateway/v1/teams/

No action needed, as upgrades from 2.4 are not supported.

Event-Driven Ansible

N/A

/api/gateway/v1/users/

No action needed, as upgrades from 2.4 are not supported.

Event-Driven Ansible

N/A

  • /api/gateway/v1/role_definitions/
  • /api/gateway/v1/role_team_assignments/
  • /api/gateway/v1/role_user_assignments/

New role capabilities included as part of the platform gateway API.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat