---
sourceDocument: Australia Enable AI
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/intelligent-experiences

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# OCI APIs

# APIs used by AI Service Graph Connector for OCI {#ariaid-title1}

Release version: Australia  
Updated July 6, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Explore the OCI APIs used by the AI Service Graph Connector for OCI
The AI Service Graph Connector for OCI calls the following OCI APIs during discovery.{#ai-sgc-oci-api__table_ns3_mf1_vjc__entry__4}

| Method | API | IAM permission | Purpose |
|-|-|-|-|
| OCI Generative AI ||||
| GET | https://identity.<var class="keyword varname">region</var>.oraclecloud.com/20160918/compartments?compartmentId=<var class="keyword varname">compartmentId</var>\&compartmentIdInSubtree=true\&lifecycleState=ACTIVE | inspect compartments | List active compartments within discovery scope. |
| GET | https://identity.<var class="keyword varname">region</var>.oraclecloud.com/20160918/compartments/<var class="keyword varname">compartmentId</var> | inspect compartments | Test connection. |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/models?compartmentId=<var class="keyword varname">compartmentId</var> | read generative-ai-family | List base and custom models. |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/importedModels?compartmentId=<var class="keyword varname">compartmentId</var> | read generative-ai-family | List imported models. |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/endpoints?compartmentId=<var class="keyword varname">compartmentId</var> | read generative-ai-family | List endpoints. |
| OCI Generative AI Agents ||||
| GET | https://identity.<var class="keyword varname">region</var>.oraclecloud.com/20160918/compartments?compartmentId=<var class="keyword varname">compartmentId</var>\&compartmentIdInSubtree=true\&lifecycleState=ACTIVE | inspect compartments | List active compartments within discovery scope. |
| GET | https://identity.<var class="keyword varname">region</var>.oraclecloud.com/20160918/compartments/<var class="keyword varname">compartmentId</var> | inspect compartments | Test connection. |
| GET | https://agent.generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20240531/agents?compartmentId=<var class="keyword varname">compartmentId</var> | read genai-agent-family | List AI agents. |
| GET | https://agent.generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20240531/tools?compartmentId=<var class="keyword varname">compartmentId</var>\&agentId=<var class="keyword varname">agentId</var> | read genai-agent-family | List tools for a specific agent. |
| GET | https://agent.generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20240531/agentEndpoints?compartmentId=<var class="keyword varname">compartmentId</var> | read genai-agent-family | List agent endpoints (used for usage metrics collection). |
| GET | https://agent.generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20240531/agentEndpoints/<var class="keyword varname">agentEndpointId</var> | read genai-agent-family | Get agent endpoint details (agent-as-tool resolution). |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/models/<var class="keyword varname">modelId</var> | read generative-ai-family | Get model details (resolve agent-referenced models). |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/endpoints/<var class="keyword varname">endpointId</var> | read generative-ai-family | Get model endpoint details (resolve agent-referenced endpoints to backing models). |
| POST | https://telemetry.<var class="keyword varname">region</var>.oraclecloud.com/20180401/metrics/actions/summarizeMetricsData | read metrics | Retrieve agent usage metrics. |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/importedModels/<var class="keyword varname">modelId</var> | read generative-ai-family | Get imported model details (resolve agent-referenced imported models). |
| GET | https://generativeai.<var class="keyword varname">region</var>.oci.oraclecloud.com/20231130/endpoints?compartmentId=<var class="keyword varname">compartmentId</var> | read generative-ai-family | List endpoints. |
[Table 1. OCI API list and IAM permissions]

{#ai-sgc-oci-api__table_ns3_mf1_vjc}

For the full API list and required IAM permissions, see the [Service Graph Connector for OCI - Setup Instructions \[KB2898105\] ](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB2898105) article in the Now Support Knowledge Base.