Skip to content
Release: Australia · Updated: 2026-07-06 · Official documentation · View source

APIs used by AI Service Graph Connector for IBM

Explore the IBM APIs used by the AI Service Graph Connector for IBM

The AI Service Graph Connector for IBM calls the following IBM APIs during discovery.

MethodAPIIAM permissionPurpose
IBM watsonx Orchestrate
GEThttps://resource-controller.cloud.ibm.com/v2/resource_instancesResource Controller ViewerDiscover all watsonx Orchestrate instances in the account.
GEThttps://api.region.watson-orchestrate.cloud.ibm.com/instances/instanceGuid/v1/orchestrate/agentsOrchestrate ReaderList all agents for an instance.
GEThttps://api.region.watson-orchestrate.cloud.ibm.com/instances/instanceGuid/v1/orchestrate/tools/toolIdOrchestrate ReaderGet details of each tool referenced by an agent.
POSThttps://api.region.watson-orchestrate.cloud.ibm.com/instances/instanceGuid/v1/traces/searchOrchestrate ReaderSearch usage trace records (cursor-paginated, separate scheduled import).
POSThttps://iam.cloud.ibm.com/identity/tokenNoneExchange API Key for IAM Bearer token.
IBM watsonx Runtime
GEThttps://api.region.dataplatform.cloud.ibm.com/v2/spacesWatson Studio ViewerList all watsonx spaces per region.
GEThttps://region.ml.cloud.ibm.com/ml/v4/deploymentsWML ViewerList all AI model deployments in a space (paginated).
GEThttps://api.region.dataplatform.cloud.ibm.com/wx/v1/prompts/promptIdWatson Studio ReaderGet prompt template details, including model_id and system prompt.
POSThttps://iam.cloud.ibm.com/identity/tokenNoneExchange API Key for IAM Bearer token.

For the full API list and required IAM permissions, see the AI Service Graph Connector for IBM — Setup Instructions [KB2901071] article in the Now Support Knowledge Base.