Foreman API v2 is currently the default API version.
Resource | Description |
---|---|
GET /api/architectures | List all architectures |
GET /api/operatingsystems/:operatingsystem_id/architectures | List all architectures for operating system |
GET /api/architectures/:id | Show an architecture |
POST /api/architectures | Create an architecture |
PUT /api/architectures/:id | Update an architecture |
DELETE /api/architectures/:id | Delete an architecture |
Resource | Description |
---|---|
GET /api/audits | List all audits |
GET /api/hosts/:host_id/audits | List all audits for a given host |
GET /api/audits/:id | Show an audit |
Resource | Description |
---|---|
GET /api/auth_source_externals | List external authentication sources |
GET /api/locations/:location_id/auth_source_externals | List external authentication sources per location |
GET /api/organizations/:organization_id/auth_source_externals | List external authentication sources per organization |
GET /api/auth_source_externals/:id | Show an external authentication source |
PUT /api/auth_source_externals/:id | Update an external authentication source |
Resource | Description |
---|---|
GET /api/auth_source_internals | List internal authentication sources |
GET /api/auth_source_internals/:id | Show an internal authentication source |
Resource | Description |
---|---|
GET /api/auth_source_ldaps | List all LDAP authentication sources |
GET /api/locations/:location_id/auth_source_ldaps | List LDAP authentication sources per location |
GET /api/organizations/:organization_id/auth_source_ldaps | List LDAP authentication sources per organization |
GET /api/auth_source_ldaps/:id | Show an LDAP authentication source |
POST /api/auth_source_ldaps | Create an LDAP authentication source |
PUT /api/auth_source_ldaps/:id | Update an LDAP authentication source |
PUT /api/auth_source_ldaps/:id/test | Test LDAP connection |
DELETE /api/auth_source_ldaps/:id | Delete an LDAP authentication source |
Resource | Description |
---|---|
GET /api/auth_sources | List all authentication sources |
GET /api/locations/:location_id/auth_sources | List all authentication sources per location |
GET /api/organizations/:organization_id/auth_sources | List all authentication sources per organization |
Resource | Description |
---|---|
GET /api/smart_proxies/:smart_proxy_id/autosign | List all autosign entries |
POST /api/smart_proxies/:smart_proxy_id/autosign | Create autosign entry |
DELETE /api/smart_proxies/:smart_proxy_id/autosign/:id | Delete autosign entry |
Resource | Description |
---|---|
GET /api/bookmarks | List all bookmarks |
GET /api/bookmarks/:id | Show a bookmark |
POST /api/bookmarks | Create a bookmark |
PUT /api/bookmarks/:id | Update a bookmark |
DELETE /api/bookmarks/:id | Delete a bookmark |
Resource | Description |
---|---|
GET /api/common_parameters | List all global parameters |
GET /api/common_parameters/:id | Show a global parameter |
POST /api/common_parameters | Create a global parameter |
PUT /api/common_parameters/:id | Update a global parameter |
DELETE /api/common_parameters/:id | Delete a global parameter |
Resource | Description |
---|---|
GET /api/compute_profiles | List of compute profiles |
GET /api/compute_profiles/:id | Show a compute profile |
POST /api/compute_profiles | Create a compute profile |
PUT /api/compute_profiles/:id | Update a compute profile |
DELETE /api/compute_profiles/:id | Delete a compute profile |
Resource | Description |
---|---|
GET /api/config_reports | List all reports |
GET /api/config_reports/:id | Show a report |
POST /api/config_reports | Create a report |
DELETE /api/config_reports/:id | Delete a report |
GET /api/hosts/:host_id/config_reports/last | Show the last report for a host |
Resource | Description |
---|---|
GET /api/dashboard | Get dashboard details |
Resource | Description |
---|---|
GET /api/domains | List of domains |
GET /api/subnets/:subnet_id/domains | List of domains per subnet |
GET /api/locations/:location_id/domains | List of domains per location |
GET /api/organizations/:organization_id/domains | List of domains per organization |
GET /api/domains/:id | Show a domain |
POST /api/domains | Create a domain |
PUT /api/domains/:id | Update a domain |
DELETE /api/domains/:id | Delete a domain |
Resource | Description |
---|---|
GET /api/usergroups/:usergroup_id/external_usergroups | List all external user groups for user group |
GET /api/auth_source_ldaps/:auth_source_ldap_id/external_usergroups | List all external user groups for LDAP authentication source |
GET /api/usergroups/:usergroup_id/external_usergroups/:id | Show an external user group for user group |
GET /api/auth_source_ldaps/:auth_source_ldap_id/external_usergroups/:id | Show an external user group for LDAP authentication source |
POST /api/usergroups/:usergroup_id/external_usergroups | Create an external user group linked to a user group |
PUT /api/usergroups/:usergroup_id/external_usergroups/:id | Update external user group |
PUT /api/usergroups/:usergroup_id/external_usergroups/:id/refresh | Refresh external user group |
DELETE /api/usergroups/:usergroup_id/external_usergroups/:id | Delete an external user group |
Resource | Description |
---|---|
GET /api/fact_values | List all fact values |
GET /api/hosts/:host_id/facts | List all fact values of a given host |
Resource | Description |
---|---|
GET /api/filters | List all filters |
GET /api/filters/:id | Show a filter |
POST /api/filters | Create a filter |
PUT /api/filters/:id | Update a filter |
DELETE /api/filters/:id | Delete a filter |
Resource | Description |
---|---|
GET /api | Show available API links |
GET /api/status | Show status |
Resource | Description |
---|---|
GET /api/host_statuses | List of host statuses |
Resource | Description |
---|---|
GET /api/hostgroups | List all host groups |
GET /api/locations/:location_id/hostgroups | List all host groups per location |
GET /api/organizations/:organization_id/hostgroups | List all host groups per organization |
GET /api/hostgroups/:id | Show a host group |
POST /api/hostgroups | Create a host group |
PUT /api/hostgroups/:id | Update a host group |
DELETE /api/hostgroups/:id | Delete a host group |
POST /api/hostgroups/:id/clone | Clone a host group |
PUT /api/hostgroups/:id/rebuild_config | Rebuild orchestration config |
Resource | Description |
---|---|
GET /api/hosts | List all hosts |
GET /api/hostgroups/:hostgroup_id/hosts | List all hosts for a host group |
GET /api/locations/:location_id/hosts | List hosts per location |
GET /api/organizations/:organization_id/hosts | List hosts per organization |
GET /api/hosts/:id | Show a host |
POST /api/hosts | Create a host |
PUT /api/hosts/:id | Update a host |
DELETE /api/hosts/:id | Delete a host |
GET /api/hosts/:id/enc | Get ENC values of host |
GET /api/hosts/:id/status/:type | Get status of host |
DELETE /api/hosts/:id/status/:type | Clear sub-status of host |
GET /api/hosts/:id/vm_compute_attributes | Get vm attributes of host |
PUT /api/hosts/:id/disassociate | Disassociate the host from a VM |
PUT /api/hosts/:id/power | Run a power operation on host |
GET /api/hosts/:id/power | Fetch the status of whether the host is powered on or not. Supported hosts are VMs and physical hosts with BMCs. |
PUT /api/hosts/:id/boot | Boot host from specified device |
POST /api/hosts/facts | Upload facts for a host, creating the host if required |
PUT /api/hosts/:id/rebuild_config | Rebuild orchestration config |
GET /api/hosts/:id/template/:kind | Preview rendered provisioning template content |
GET /api/hosts/:id/templates | Get provisioning templates for the host |
Resource | Description |
---|---|
GET /api/http_proxies | List of HTTP Proxies |
GET /api/http_proxies/:id | Show an HTTP Proxy |
POST /api/http_proxies | Create an HTTP Proxy |
PUT /api/http_proxies/:id | Update an HTTP Proxy |
DELETE /api/http_proxies/:id | Delete an HTTP Proxy |
Resource | Description |
---|---|
GET /api/compute_resources/:compute_resource_id/images | List all images for a compute resource |
GET /api/operatingsystems/:operatingsystem_id/images | List all images for operating system |
GET /api/architectures/:architecture_id/images | List all images for architecture |
GET /api/compute_resources/:compute_resource_id/images/:id | Show an image |
GET /api/operatingsystems/:operatingsystem_id/images/:id | Show an image |
GET /api/architectures/:architecture_id/images/:id | Show an image |
POST /api/compute_resources/:compute_resource_id/images | Create an image |
PUT /api/compute_resources/:compute_resource_id/images/:id | Update an image |
DELETE /api/compute_resources/:compute_resource_id/images/:id | Delete an image |
Resource | Description |
---|---|
PUT /api/instance_hosts/:host_id | Assign a host to the Foreman instance |
GET /api/instance_hosts | List hosts forming the Foreman instance |
DESTROY /api/instance_hosts/:host_id | Unassign a given host from the Foreman instance |
Resource | Description |
---|---|
GET /api/hosts/:host_id/interfaces | List all interfaces for host |
GET /api/domains/:domain_id/interfaces | List all interfaces for domain |
GET /api/subnets/:subnet_id/interfaces | List all interfaces for subnet |
GET /api/hosts/:host_id/interfaces/:id | Show an interface for host |
POST /api/hosts/:host_id/interfaces | Create an interface on a host |
PUT /api/hosts/:host_id/interfaces/:id | Update a host's interface |
DELETE /api/hosts/:host_id/interfaces/:id | Delete a host's interface |
Resource | Description |
---|---|
GET /api/locations | List all locations |
GET /api/locations/:id | Show a location |
POST /api/locations | Create a location |
PUT /api/locations/:id | Update a location |
DELETE /api/locations/:id | Delete a location |
Resource | Description |
---|---|
GET /api/mail_notifications | List of email notifications |
GET /api/mail_notifications/:id | Show an email notification |
POST /api/users/:user_id/mail_notifications | Add an email notification for a user |
PUT /api/users/:user_id/mail_notifications/:mail_notification_id | Update an email notification for a user |
DELETE /api/users/:user_id/mail_notifications/:mail_notification_id | Remove an email notification for a user |
GET /api/users/:user_id/mail_notifications | List all email notifications for a user |
Resource | Description |
---|---|
GET /api/media | List all installation media |
GET /api/operatingsystems/:operatingsystem_id/media | List all media for an operating system |
GET /api/locations/:location_id/media | List all media per location |
GET /api/organizations/:organization_id/media | List all media per organization |
GET /api/media/:id | Show a medium |
POST /api/media | Create a medium |
PUT /api/media/:id | Update a medium |
DELETE /api/media/:id | Delete a medium |
Resource | Description |
---|---|
GET /api/models | List all hardware models |
GET /api/models/:id | Show a hardware model |
POST /api/models | Create a hardware model |
PUT /api/models/:id | Update a hardware model |
DELETE /api/models/:id | Delete a hardware model |
Resource | Description |
---|---|
GET /api/operatingsystems | List all operating systems |
GET /api/architectures/:architecture_id/operatingsystems | List all operating systems for nested architecture |
GET /api/media/:medium_id/operatingsystems | List all operating systems for nested medium |
GET /api/ptables/:ptable_id/operatingsystems | List all operating systems for nested partition table |
GET /api/provisioning_templates/:provisioning_template_id/operatingsystems | List all operating systems for nested provisioning template |
GET /api/operatingsystems/:id | Show an operating system |
POST /api/operatingsystems | Create an operating system |
PUT /api/operatingsystems/:id | Update an operating system |
DELETE /api/operatingsystems/:id | Delete an operating system |
GET /api/operatingsystems/:id/bootfiles | List boot files for an operating system |
Resource | Description |
---|---|
GET /api/organizations | List all organizations |
GET /api/organizations/:id | Show an organization |
POST /api/organizations | Create an organization |
PUT /api/organizations/:id | Update an organization |
DELETE /api/organizations/:id | Delete an organization |
Resource | Description |
---|---|
GET /api/operatingsystems/:operatingsystem_id/os_default_templates | List default templates combinations for an operating system |
GET /api/provisioning_templates/:provisioning_template_id/os_default_templates | List operating systems where this template is set as a default |
GET /api/operatingsystems/:operatingsystem_id/os_default_templates/:id | Show a default template combination for an operating system |
POST /api/operatingsystems/:operatingsystem_id/os_default_templates | Create a default template combination for an operating system |
PUT /api/operatingsystems/:operatingsystem_id/os_default_templates/:id | Update a default template combination for an operating system |
DELETE /api/operatingsystems/:operatingsystem_id/os_default_templates/:id | Delete a default template combination for an operating system |
Resource | Description |
---|---|
GET /api/permissions | List all permissions |
GET /api/permissions/:id | Show a permission |
GET /api/permissions/resource_types | List available resource types |
Resource | Description |
---|---|
GET /api/users/:user_id/personal_access_tokens | List all Personal Access Tokens for a user |
GET /api/users/:user_id/personal_access_tokens/:id | Show a Personal Access Token for a user |
POST /api/users/:user_id/personal_access_tokens | Create a Personal Access Token for a user |
DELETE /api/users/:user_id/personal_access_tokens/:id | Revoke a Personal Access Token for a user |
Resource | Description |
---|---|
GET /api/ping | Shows status of Foreman system and it's subcomponents |
GET /api/statuses | Shows status and version information of Foreman system and it's subcomponents |
Resource | Description |
---|---|
GET /api/plugins | List installed plugins |
Resource | Description |
---|---|
GET /api/ptables | List all partition tables |
GET /api/operatingsystems/:operatingsystem_id/ptables | List all partition tables for an operating system |
GET /api/locations/:location_id/ptables | List all partition tables per location |
GET /api/organizations/:organization_id/ptables | List all partition tables per organization |
GET /api/ptables/:id | Show a partition table |
POST /api/ptables | Create a partition table |
POST /api/ptables/import | Import a partition table |
GET /api/ptables/revision | |
PUT /api/ptables/:id | Update a partition table |
DELETE /api/ptables/:id | Delete a partition table |
POST /api/ptables/:id/clone | Clone a template |
GET /api/ptables/:id/export | Export a partition template to ERB |
Resource | Description |
---|---|
GET /api/realms | List of realms |
GET /api/realms/:id | Show a realm |
POST /api/realms | Create a realm |
PUT /api/realms/:id | Update a realm |
DELETE /api/realms/:id | Delete a realm |
Resource | Description |
---|---|
GET /api/register | Render Global registration template |
POST /api/register | Find or create a host and render the 'Host initial configuration' template |
Resource | Description |
---|---|
POST /api/registration_commands | Generate global registration command |
Resource | Description |
---|---|
GET /api/report_templates | List all report templates |
GET /api/locations/:location_id/report_templates | List all report templates per location |
GET /api/organizations/:organization_id/report_templates | List all report templates per organization |
GET /api/report_templates/:id | Show a report template |
POST /api/report_templates | Create a report template |
POST /api/report_templates/import | Import a report template |
GET /api/report_templates/revision | |
PUT /api/report_templates/:id | Update a report template |
DELETE /api/report_templates/:id | Delete a report template |
POST /api/report_templates/:id/clone | Clone a template |
GET /api/report_templates/:id/export | Export a report template to ERB |
POST /api/report_templates/:id/generate | Generate report from a template |
POST /api/report_templates/:id/schedule_report | Schedule generating of a report |
GET /api/report_templates/:id/report_data/:job_id | Downloads a generated report |
Resource | Description |
---|---|
GET /api/roles | List all roles |
GET /api/roles/:id | Show a role |
POST /api/roles | Create a role |
PUT /api/roles/:id | Update a role |
DELETE /api/roles/:id | Delete a role |
POST /api/roles/:id/clone | Clone a role |
Resource | Description |
---|---|
GET /api/settings | List all settings |
GET /api/settings/:id | Show a setting |
PUT /api/settings/:id | Update a setting |
Resource | Description |
---|---|
GET /api/smart_proxies | List all smart proxies |
GET /api/smart_proxies/:id | Show a smart proxy |
POST /api/smart_proxies | Create a smart proxy |
PUT /api/smart_proxies/:id | Update a smart proxy |
DELETE /api/smart_proxies/:id | Delete a smart proxy |
PUT /api/smart_proxies/:id/refresh | Refresh smart proxy features |
POST /api/smart_proxies/:id/import_subnets | Import subnets from Smart proxy |
Resource | Description |
---|---|
PUT /api/smart_proxies/:smart_proxy_id/hosts/:host_id | Assign a host to the smart proxy |
GET /api/smart_proxies/:smart_proxy_id/hosts | Get hosts forming the smart proxy |
DELETE /api/smart_proxies/:smart_proxy_id/hosts/:host_id | Unassign a given host from the smart proxy |
Resource | Description |
---|---|
GET /api/users/:user_id/ssh_keys | List all SSH keys for a user |
GET /api/users/:user_id/ssh_keys/:id | Show an SSH key from a user |
POST /api/users/:user_id/ssh_keys | Add an SSH key for a user |
DELETE /api/users/:user_id/ssh_keys/:id | Delete an SSH key for a user |
Resource | Description |
---|---|
GET /api/subnets | List of subnets |
GET /api/domains/:domain_id/subnets | List of subnets for a domain |
GET /api/locations/:location_id/subnets | List of subnets per location |
GET /api/organizations/:organization_id/subnets | List of subnets per organization |
GET /api/subnets/:id | Show a subnet |
POST /api/subnets | Create a subnet |
PUT /api/subnets/:id | Update a subnet |
DELETE /api/subnets/:id | Delete a subnet |
GET /api/subnets/:id/freeip | Provides an unused IP address in this subnet |
Resource | Description |
---|---|
GET /api/users/:user_id/table_preferences | List of table preferences for a user |
GET /api/users/:user_id/table_preferences/:name | Table preference details of a given table |
POST /api/users/:user_id/table_preferences | Creates a table preference for a given table |
PUT /api/users/:user_id/table_preferences/:name | Updates a table preference for a given table |
DELETE /api/users/:user_id/table_preferences/:name | Delete a table preference for a given table |
Resource | Description |
---|---|
GET /api/orchestration/:id/tasks | List all tasks for a given orchestration event |
Resource | Description |
---|---|
GET /api/provisioning_templates/:provisioning_template_id/template_combinations | List template combination |
GET /api/hostgroups/:hostgroup_id/template_combinations | List template combination |
POST /api/provisioning_templates/:provisioning_template_id/template_combinations | Add a template combination |
POST /api/hostgroups/:hostgroup_id/template_combinations | Add a template combination |
GET /api/template_combinations/:id | Show template combination |
GET /api/provisioning_templates/:provisioning_template_id/template_combinations/:id | Show template combination |
GET /api/hostgroups/:hostgroup_id/template_combinations/:id | Show template combination |
PUT /api/provisioning_templates/:provisioning_template_id/template_combinations/:id | Update template combination |
PUT /api/hostgroups/:hostgroup_id/template_combinations/:id | Update template combination |
DELETE /api/template_combinations/:id | Delete a template combination |
Resource | Description |
---|---|
GET /api/templates/:template_id/template_inputs | List template inputs |
GET /api/templates/:template_id/template_inputs/:id | Show template input details |
POST /api/templates/:template_id/template_inputs | Create a template input |
DELETE /api/templates/:template_id/template_inputs/:id | Delete a template input |
PUT /api/templates/:template_id/template_inputs/:id | Update a template input |
Resource | Description |
---|---|
GET /api/template_kinds | List all template kinds |
Resource | Description |
---|---|
GET /api/usergroups | List all user groups |
GET /api/usergroups/:id | Show a user group |
POST /api/usergroups | Create a user group |
PUT /api/usergroups/:id | Update a user group |
DELETE /api/usergroups/:id | Delete a user group |
Resource | Description |
---|---|
GET /api/users | List all users |
GET /api/auth_source_ldaps/:auth_source_ldap_id/users | List all users for LDAP authentication source |
GET /api/auth_source_externals/:auth_source_external_id/users | List all users for external authentication source |
GET /api/usergroups/:usergroup_id/users | List all users for user group |
GET /api/roles/:role_id/users | List all users for role |
GET /api/locations/:location_id/users | List all users for location |
GET /api/organizations/:organization_id/users | List all users for organization |
GET /api/users/:id | Show a user |
GET /api/current_user | Show the currently logged-in user |
POST /api/users | Create a user |
PUT /api/users/:id | Update a user |
DELETE /api/users/:id | Delete a user |
GET /api/users/extlogin | Use to authenticate against external authentication source |