--- sourceDocument: Australia ServiceNow AI Platform Capabilities sourceDocumentLink: https://www.servicenow.com/docs/r/australia/servicenow-platform Release : - australia ft:locale : - en-US ft:publication_title : - Australia ServiceNow AI Platform Capabilities ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Use application services APIs # Use application services APIs {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Use Application Services APIs Application services APIs enable you to create, update, and manage service instances within your organization. A service instance consists of interconnected applications and hosts configured to provide a specific service, either internally or externally. To utilize these APIs, the role ofappserviceadminis required. Show full answer Show less ## Key Features * **Create Service Instances:** Use the `createOrUpdateService` POST REST API to create a service instance. This is effective if the required Configuration Items (CIs) are already present in the ServiceNow CMDB, either manually or via Discovery. * **Retrieve CI Details:** Employ the `getContent` GET REST API to access lists of CIs and their relationships for manually created service instances. * **JavaScript APIs:** Additional functions include: * `addCI()`: Add a CI to a service instance. * `addManualConnection()`: Establish a manual connection to a service instance. * `migrateManualToApplicationService()`: Convert a manual service to an application service. * `populateApplicationService()`: Populate a service instance with CIs from a specified entry point. * `removeCI()`: Remove a CI from a service instance. * `removeManualConnection()`: Delete a manual connection and the associated CI. ## Key Outcomes By leveraging these APIs, ServiceNow customers can efficiently manage their service instances, ensuring that all CIs are accurately represented and interconnected. This enhances the organization's ability to understand and utilize their service architecture effectively. Application services provide APIs that let you perform operations such as creating and updating an service instance, populating it with CIs from the CMDB, and retrieving details from an existing service instance. Role required: app_service_admin A service instance is a set of interconnected applications and hosts that are configured to offer a service to the organization. Service instances can be internal, like an organization email system or customer-facing, like an organization website. ## Create an application service {#use-app-services-api__section_i1y_b2g_sdb} Using the [createOrUpdateService - POST](https://www.servicenow.com/docs/access?context=application-service-api&version=australia&pubname=australia-api-reference&ft:locale=en-US) REST API to create an service instance suits your organization if the ServiceNow CMDB already contains the CIs making up the service. Typically, it is the case when you have manually added CIs directly into the CMDB, or used the Discovery application to discover CIs and store information about them in the CMDB. You can also use this API to create an service instance containing CIs discovered using non-ServiceNow applications. By default, when an service instance is created, all CI connections are of the Depends on::Used by relationship type. You can modify this default type by changing the value of the [sa.it_service.manual_ci_rel_type](https://www.servicenow.com/docs/S20~n_F1J6vAuaDhpzyp6Q "Several types of components are installed with activation of the Application Service [com.snc.cmdb.it_service] plugin, including tables, user roles, and scheduled jobs.") property. Before creating an application service, ensure that: * The CMDB contains all the CIs comprising the application service. * You have the sys_id of each CI comprised in the application service you want to create. * You understand the hierarchy that the CIs form. {#use-app-services-api__ul_cdh_hjg_sdb} The Mapped Application Service \[cmdb_ci_service_discovered\] table contains every service instance including services you create using APIs. You can also manually create an service instance using the user interface as described in [Create a Service instance (application service)](https://www.servicenow.com/docs/LKd87HjvwYKREPw7DmJc5Q "Create an application service to adhere to Common Service Data Model standards and to standardize the organization, maintenance, and monitoring of services in your organization."). ## Retrieve content from an application service {#use-app-services-api__section_t1d_c2g_sdb} Use the [getContent - GET](https://www.servicenow.com/docs/access?context=application-service-api&version=australia&pubname=australia-api-reference&ft:locale=en-US) REST API to retrieve a list of CIs and the relationships between them, for an application service that was created manually. ## Additional APIs {#use-app-services-api__section_cgl_4y5_wdb} The following JavaScript APIs are also available: * [addCI()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Add a CI to a manually created an service instance. For restrictions on the CIs being added and other details about adding a CI to an service instance, see [Manually add CIs to an application service](https://www.servicenow.com/docs/RNCxG79WJay_ri~VVJxNrA "Add configuration items to manually created application services or to services discovered by Service Mapping."). * [addManualConnection()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Add a manually created connection to an application service. * [migrateManualToApplicationService()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Convert a manual service to an application service. * [populateApplicationService()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Populate an application service with CIs and relationships from the designated entry point. * [removeCI()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Remove a manually created CI from an application service. * [removeManualConnection()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US): Remove a manually created connection and the connected CI from an application service. {#use-app-services-api__ul_h5f_qy5_wdb} **Related topics** * [Application Service API](https://www.servicenow.com/docs/access?context=application-service-api&version=australia&pubname=australia-api-reference&ft:locale=en-US)