api_call
InactiveTool of ComOS Federation Gateway
Call any comAI API endpoint not covered by specific tools. Use this for: payments, shipping rates, recommendations, returns, user profiles, policies, help articles, and more. Read the 'api_documentation' resource first to see available endpoints and their parameters. IMPORTANT: For multi-tenant operations (checkout, cart, orders), you MUST specify the tenant_id parameter. The tenant_id should match the tenant where the cart/customer data exists (e.g., 'vnm-sport', not 'test-test'). Common endpoints: - GET /v1/users/{userId} - Get user profile - GET /v1/recommendations/{userId} - Get personalized recommendations - GET /v1/shipping/rates - Calculate shipping rates - POST /v1/checkout - Process checkout (requires tenant_id) - GET /v1/returns/{returnId} - Check return status - POST /v1/returns - Request a return - GET /v1/help - Search help articles - GET /v1/policies - List store policies - GET /v1/api-keys - List user's API keys (requires auth) - POST /v1/api-keys - Create new API key (requires auth) (Federated: requires tenant_id. For cart/orders, pass auth_token from POST /v1/auth/login. Product IDs are MongoDB ObjectIds from catalog_search.)
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tenant_id",
"method",
"path"
],
"properties": {
"body": {
"type": "object",
"description": "Request body for POST/PUT/PATCH requests",
"additionalProperties": {}
},
"path": {
"type": "string",
"description": "API path starting with /v1/ (e.g., '/v1/shipping/rates')"
},
"method": {
"type": "string",
"description": "HTTP method"
},
"params": {
"type": "object",
"description": "Query parameters as key-value pairs",
"additionalProperties": {}
},
"tenant_id": {
"type": "string",
"description": "Override tenant ID for multi-tenant operations. Required for checkout, cart, and order operations to ensure correct tenant context."
},
"auth_token": {
"type": "string",
"description": "JWT auth token for authenticated operations (cart, orders). Get from api_call POST /v1/auth/login."
}
},
"additionalProperties": false
}Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries