> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Elenca i log di audit
> Elenca i log di audit dell’Enterprise.
I log di audit includono l'azione `ai_guardrail_violation`, registrata quando viene attivata una barriera di sicurezza. Per i dettagli su come configurare le barriere di sicurezza, consulta la guida alla funzionalità [AI Guardrails](/it/enterprise/features/ai-guardrails).
## Autorizzazioni
Richiede un utente di servizio con l'autorizzazione `ManageEnterpriseSettings` a livello Enterprise.
## Filtri temporali
Questo endpoint supporta filtri temporali opzionali tramite i parametri di query `time_after` e `time_before`.
* Sia `time_after` che `time_before` sono **timestamp Unix in secondi**, interpretati come UTC.
* Se fornisci `time_before`, devi fornire anche `time_after`.
* L'intervallo di tempo tra `time_after` e `time_before` deve essere di **100 giorni o meno**.
* Se non vengono specificati filtri temporali, l'API restituisce i log di audit per l’intera cronologia disponibile (soggetta a paginazione).
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/enterprise/audit-logs
openapi: 3.1.0
info:
description: API Devin v3 con autenticazione utente di servizio e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/enterprise/audit-logs:
get:
tags:
- audit_logs
summary: Elenca i log di audit
description: Elenca i log di audit dell’Enterprise.
operationId: handle_get_enterprise_audit_logs_v3_enterprise_audit_logs_get
parameters:
- in: query
name: order
required: false
schema:
default: desc
enum:
- asc
- desc
title: Order
type: string
- in: query
name: time_before
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time Before
- in: query
name: time_after
required: false
schema:
anyOf:
- type: integer
- type: 'null'
title: Time After
- in: query
name: after
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- in: query
name: first
required: false
schema:
default: 100
maximum: 200
minimum: 1
title: First
type: integer
- in: query
name: action
required: false
schema:
anyOf:
- $ref: '#/components/schemas/AuditLogAction'
- type: 'null'
title: Action
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_AuditLogResponse_'
description: Risposta riuscita
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Errore di validazione
components:
schemas:
AuditLogAction:
enum:
- login
- create_org
- update_org
- delete_org
- revoke_all_enterprise_api_keys
- add_enterprise_member
- delete_member
- add_member
- assign_roles
- update_role
- create_role
- delete_role
- add_group_membership
- update_group_membership
- delete_group_membership
- create_knowledge
- edit_knowledge
- delete_knowledge
- create_folder
- update_folder
- delete_folder
- create_session
- sleep_session
- terminate_session
- send_message
- create_service_api_key
- revoke_enterprise_api_key
- create_gitlab_integration
- update_gitlab_integration
- reconnect_gitlab_integration
- delete_gitlab_integration
- create_gitlab_app_config
- create_azure_devops_integration
- reconnect_azure_devops_integration
- delete_azure_devops_integration
- remove_repo_from_devin
- update_enterprise_hypervisor_settings
- update_enterprise_settings
- update_org_settings
- update_code_snippet_telemetry
- ai_guardrail_violation
- update_ai_guardrail
- approve_deploy
- approve_test_app
- permission_response
- search_query
- create_org_api_key
- create_user_api_key
- view_org_api_key
- view_user_api_key
- create_secret
- update_secret
- delete_secret
- create_playbook
- update_playbook
- delete_playbook
- enable_persona
- disable_persona
- delete_persona
- start_repo_setup
- delete_repo_setup
- finish_repo_setup
- github_integration_deleted
- create_github_integration
- delete_github_integration
- refresh_github_integration
- create_bitbucket_integration
- delete_bitbucket_integration
- mcp_server_install
- mcp_server_update
- mcp_server_enable
- mcp_server_disable
- mcp_server_delete
- mcp_server_secret_link
- mcp_server_secret_unlink
- mcp_server_oauth_initiate
- mcp_server_oauth_tokens_granted
- mcp_server_oauth_tokens_revoked
- create_mcp_validation_session
- secure_mode_profile_created
- secure_mode_profile_updated
- secure_mode_binding_created
- secure_mode_binding_updated
- secure_mode_binding_deleted
- create_service_user
- update_service_user
- delete_service_user
- assign_service_user_role
- remove_service_user_role
- create_git_permission
- delete_git_permission
- update_git_permission
- create_maintenance_task
- update_maintenance_task
- delete_maintenance_task
- create_snapshot_script
- schedule_snapshot_script
- execute_snapshot_script
- update_repo_setup_steering_knowledge
- delete_repo_setup_steering_knowledge
- set_org_group_limits
- create_join_request
- approve_join_request
- automatic_join_event
- reject_join_request
- create_seat_request
- approve_seat_request
- decline_seat_request
- create_service_user_api_key
- revoke_service_user_api_key
- rotate_service_user_api_key
- create_pat
- revoke_pat
- rotate_pat
- create_blueprint
- create_blueprint_version
- rollback_blueprint_version
- delete_blueprint
- reorder_blueprints
- create_enterprise_blueprint
- create_enterprise_blueprint_version
- rollback_enterprise_blueprint_version
- delete_enterprise_blueprint
- accept_skill_pr
- trigger_blueprint_build
- cancel_blueprint_build
- upload_blueprint_file
- delete_blueprint_file
- sync_repo_blueprints
- detach_blueprint_from_git
- create_blueprint_pr
- pin_build
- unpin_build
- delete_build
- trigger_automation
- create_automation
- update_automation
- delete_automation
- reset_automation_monitor
- update_automation_scratch
- regenerate_automation_webhook_secret
- acknowledge_session_hard_cap
- create_audit_log_export
- update_audit_log_export
- delete_audit_log_export
- create_outpost_pool
- delete_outpost_pool
- claim_outpost_session
- release_outpost_session
title: AuditLogAction
type: string
PaginatedResponse_AuditLogResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursore per recuperare la pagina successiva, oppure None se si
tratta dell’ultima pagina.
title: End Cursor
has_next_page:
default: false
description: Indica se dopo questa pagina sono disponibili altri elementi.
title: Has Next Page
type: boolean
items:
items:
$ref: '#/components/schemas/AuditLogResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: >-
Conteggio totale opzionale (può essere omesso per motivi di
performance).
title: Total
required:
- items
title: PaginatedResponse[AuditLogResponse]
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
AuditLogResponse:
properties:
action:
$ref: '#/components/schemas/AuditLogAction'
audit_log_id:
title: Audit Log Id
type: string
created_at:
title: Created At
type: integer
data:
additionalProperties: true
title: Data
type: object
org_id:
anyOf:
- type: string
- type: 'null'
title: Org Id
service_user_id:
anyOf:
- type: string
- type: 'null'
title: Service User Id
service_user_name:
anyOf:
- type: string
- type: 'null'
title: Service User Name
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
required:
- audit_log_id
- action
- created_at
- org_id
- user_id
- user_email
- service_user_id
- service_user_name
- data
title: AuditLogResponse
type: object
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````