{"method":"POST","path":"https://api.revcent.com/v2/ai_voice_agents/{ai_voice_agent_id}/trigger","summary":"Trigger An AI Voice Agent","description":"Trigger a specific AI Voice Agent using the AI Voice Agent ID and trigger path. Note: Only AI Voice Agents with a Call Method = 'Outbound' and Trigger = 'On Demand' can be triggered via API. Triggering an AI Voice Agent will immediately generate an outbound AI Voice Call that will dial the customer phone number associated with the item. If you do not know an AI Voice Agent's ID, get the list of AI Voice Agent's using the GetAIVoiceAgents operation, then find the ID for the AI Voice Agent you wish to trigger. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/TriggerAIVoiceAgent.md for an in-depth overview of this operation.","operationId":"TriggerAIVoiceAgent","parameters":[{"in":"path","name":"ai_voice_agent_id","description":"The AI Voice Agent ID","required":true,"schema":{"type":"string","title":"AI Voice Agent ID","description":"A 20 character AI Voice Agent ID.","minLength":20,"maxLength":20}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"source_type":{"type":"string","description":"Must equal 'item'","enum":["item"]},"item_type":{"type":"string","description":"Specify the item type.","enum":["sale","customer","product_sale","shipping","subscription","subscription_renewal","salvage_transaction","transaction","chargeback","fraud_detection"]},"item_id":{"type":"string","description":"Provide the ID of the item corresponding to the item_type.","minLength":20,"maxLength":20}},"required":["source_type","item_type","item_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"ai_voice_call_id":{"type":"string","title":"AI Voice Call ID","description":"A 20 character AI Voice Call ID.","minLength":20,"maxLength":20},"ai_voice_agent_id":{"type":"string","title":"AI Voice Agent ID","description":"A 20 character AI Voice Agent ID.","minLength":20,"maxLength":20},"customer_id":{"title":"Customer ID","type":"string","description":"A 20 character customer ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}