{"name":"Teclia Agent API","version":"1.0.0","description":"This API allows AI agents to perform actions inside Teclia on behalf of an authenticated user. All operations are scoped to the user's tenant and permissions.","authentication":{"type":"Bearer token","header":"Authorization: Bearer {token}","note":"The JWT token is the same used by the Teclia frontend. It is provided by the system that invokes the agent — the user never handles it directly."},"base_url":"https://api.teclia.com","how_to_use":["1. Call GET /tools to see available tool groups.","2. Call GET /tools/{group} to load the full schema for a group.","3. Call POST /tools/{group}/{tool_name} with a JSON body to execute a tool."],"groups":[{"name":"tickets","tools_count":12,"tools":["list_tickets","get_ticket","search_tickets","create_ticket","update_ticket","close_ticket","reopen_ticket","assign_ticket","send_message","add_note","get_messages","get_stats"],"how_to_load":"GET /tools/tickets","how_to_call":"POST /tools/tickets/{tool_name}"},{"name":"contacts","tools_count":7,"tools":["list_contacts","get_contact","search_contacts","create_contact","update_contact","list_contact_tickets","check_duplicate"],"how_to_load":"GET /tools/contacts","how_to_call":"POST /tools/contacts/{tool_name}"},{"name":"companies","tools_count":5,"tools":["list_companies","get_company","search_companies","create_company","update_company"],"how_to_load":"GET /tools/companies","how_to_call":"POST /tools/companies/{tool_name}"},{"name":"users","tools_count":5,"tools":["list_users","get_user","get_current_user","list_roles","create_user"],"how_to_load":"GET /tools/users","how_to_call":"POST /tools/users/{tool_name}"},{"name":"departments","tools_count":5,"tools":["list_departments","get_department","create_department","add_member","remove_member"],"how_to_load":"GET /tools/departments","how_to_call":"POST /tools/departments/{tool_name}"},{"name":"tags","tools_count":3,"tools":["list_tags","create_tag","delete_tag"],"how_to_load":"GET /tools/tags","how_to_call":"POST /tools/tags/{tool_name}"},{"name":"canned_responses","tools_count":3,"tools":["list_canned_responses","search_canned_responses","create_canned_response"],"how_to_load":"GET /tools/canned_responses","how_to_call":"POST /tools/canned_responses/{tool_name}"},{"name":"knowledge","tools_count":4,"tools":["list_knowledge_bases","search_knowledge","list_faqs","list_documents"],"how_to_load":"GET /tools/knowledge","how_to_call":"POST /tools/knowledge/{tool_name}"},{"name":"reports","tools_count":4,"tools":["ticket_volume","team_performance","satisfaction_report","department_stats"],"how_to_load":"GET /tools/reports","how_to_call":"POST /tools/reports/{tool_name}"},{"name":"schedule","tools_count":5,"tools":["list_events","get_event","create_event","update_event","cancel_event"],"how_to_load":"GET /tools/schedule","how_to_call":"POST /tools/schedule/{tool_name}"},{"name":"funnel","tools_count":8,"tools":["list_funnels","get_funnel","list_cards","get_card","create_card","move_card","update_card","close_card"],"how_to_load":"GET /tools/funnel","how_to_call":"POST /tools/funnel/{tool_name}"},{"name":"workspaces","tools_count":7,"tools":["list_workspaces","get_workspace","create_workspace","update_workspace","add_member","remove_member","list_workspace_departments"],"how_to_load":"GET /tools/workspaces","how_to_call":"POST /tools/workspaces/{tool_name}"},{"name":"forms","tools_count":9,"tools":["list_forms","get_form","create_form","update_form","link_department","add_field","update_field","remove_field","list_submissions"],"how_to_load":"GET /tools/forms","how_to_call":"POST /tools/forms/{tool_name}"}]}