Analytics and logs

List audit logs

Fetch all audit logs for a specific org.

get/orgs/audit-logs

Request

  • Base URL: https://api.useinvent.com
  • URL: https://api.useinvent.com/orgs/audit-logs
  • Auth: HTTP bearer

Query parameters

action'ALL' | 'org.updated' | 'org.deleted' | 'org.disabled' | 'org.enabled' | 'org.restored' | 'org.transferred' | 'org.transferred_to' | 'org.detached' | 'org.detached_from' | 'org.sub_org.created' | 'org.sub_org.updated' | 'org.sub_org.member.joined' | 'org.sub_org.member.role.changed' | 'member.invited' | 'member.joined' | 'member.removed' | 'member.left' | 'member.role.changed' | 'role.created' | 'role.updated' | 'role.deleted' | 'role.assigned' | 'role.unassigned' | 'assistant.created' | 'assistant.updated' | 'assistant.deleted' | 'assistant.restored' | 'assistant.duplicated' | 'assistant.duplicated_from' | 'assistant.secret.rotated' | 'assistant.knowledge.attached' | 'assistant.knowledge.detached' | 'assistant.member.added' | 'assistant.member.removed' | 'agent.created' | 'agent.updated' | 'agent.deleted' | 'agent.duplicated' | 'action.created' | 'action.updated' | 'action.deleted' | 'action.enabled' | 'action.disabled' | 'channel.created' | 'channel.deleted' | 'channel.updated' | 'channel.enabled' | 'channel.disabled' | 'broadcast.created' | 'broadcast.updated' | 'broadcast.deleted' | 'broadcast.duplicated' | 'broadcast.activated' | 'broadcast.paused' | 'broadcast.scheduled' | 'broadcast.cancelled' | 'domain.created' | 'domain.deleted' | 'email.domain.created' | 'email.domain.deleted' | 'sso.profile.created' | 'sso.profile.updated' | 'sso.profile.deleted' | 'sso.profile.sessions.revoked' | 'sso.domain.create_code.requested' | 'sso.domain.delete_code.requested' | 'sso.domain.created' | 'sso.domain.updated' | 'sso.domain.deleted' | 'email.identity.created' | 'email.identity.updated' | 'email.identity.deleted' | 'chat.deleted' | 'workflow.created' | 'workflow.deleted' | 'workflow.restored' | 'connection.created' | 'connection.updated' | 'connection.deleted' | 'api_key.created' | 'api_key.updated' | 'api_key.deleted' | 'api_key.rotated' | 'webhook.created' | 'webhook.updated' | 'webhook.deleted' | 'webhook.secret.rotated' | 'segment.created' | 'segment.updated' | 'segment.deleted' | 'table.created' | 'table.updated' | 'table.deleted' | 'table.duplicated' | 'field.created' | 'field.updated' | 'field.deleted' | 'routine.created' | 'routine.updated' | 'routine.deleted' | 'routine.token.rotated' | 'billing.updated' | 'billing.payment_method.linked' | 'billing.payment_method.unlinked' | 'subscription.changed'

Filter by action type

fromstring date-time nullable

Filter logs from this date (inclusive), YYYY-MM-DD

tostring date-time nullable

Filter logs until this date (inclusive), YYYY-MM-DD

user_idstring

Filter by user who performed the action

assistant_idstring

Filter by affected assistant

agent_idstring

Filter by affected agent

workflow_idstring

Filter by affected workflow

connection_idstring

Filter by affected connection

pagenumber

Page number

takenumber

Number of items to take

nextstring

Next page token (Only used on special endpoints)

progressiveboolean

Skip the total count: pagination-count is exact on the last page, and one more than the items so far while more pages exist (Only used on special endpoints)

Response

An array of audit log entries.

idstring required

Unique audit log entry ID

action'org.updated' | 'org.deleted' | 'org.disabled' | 'org.enabled' | 'org.restored' | 'org.transferred' | 'org.transferred_to' | 'org.detached' | 'org.detached_from' | 'org.sub_org.created' | 'org.sub_org.updated' | 'org.sub_org.member.joined' | 'org.sub_org.member.role.changed' | 'member.invited' | 'member.joined' | 'member.removed' | 'member.left' | 'member.role.changed' | 'role.created' | 'role.updated' | 'role.deleted' | 'role.assigned' | 'role.unassigned' | 'assistant.created' | 'assistant.updated' | 'assistant.deleted' | 'assistant.restored' | 'assistant.duplicated' | 'assistant.duplicated_from' | 'assistant.secret.rotated' | 'assistant.knowledge.attached' | 'assistant.knowledge.detached' | 'assistant.member.added' | 'assistant.member.removed' | 'agent.created' | 'agent.updated' | 'agent.deleted' | 'agent.duplicated' | 'action.created' | 'action.updated' | 'action.deleted' | 'action.enabled' | 'action.disabled' | 'channel.created' | 'channel.deleted' | 'channel.updated' | 'channel.enabled' | 'channel.disabled' | 'broadcast.created' | 'broadcast.updated' | 'broadcast.deleted' | 'broadcast.duplicated' | 'broadcast.activated' | 'broadcast.paused' | 'broadcast.scheduled' | 'broadcast.cancelled' | 'domain.created' | 'domain.deleted' | 'email.domain.created' | 'email.domain.deleted' | 'sso.profile.created' | 'sso.profile.updated' | 'sso.profile.deleted' | 'sso.profile.sessions.revoked' | 'sso.domain.create_code.requested' | 'sso.domain.delete_code.requested' | 'sso.domain.created' | 'sso.domain.updated' | 'sso.domain.deleted' | 'email.identity.created' | 'email.identity.updated' | 'email.identity.deleted' | 'chat.deleted' | 'workflow.created' | 'workflow.deleted' | 'workflow.restored' | 'connection.created' | 'connection.updated' | 'connection.deleted' | 'api_key.created' | 'api_key.updated' | 'api_key.deleted' | 'api_key.rotated' | 'webhook.created' | 'webhook.updated' | 'webhook.deleted' | 'webhook.secret.rotated' | 'segment.created' | 'segment.updated' | 'segment.deleted' | 'table.created' | 'table.updated' | 'table.deleted' | 'table.duplicated' | 'field.created' | 'field.updated' | 'field.deleted' | 'routine.created' | 'routine.updated' | 'routine.deleted' | 'routine.token.rotated' | 'billing.updated' | 'billing.payment_method.linked' | 'billing.payment_method.unlinked' | 'subscription.changed' required

The action that was performed

source'app' | 'admin' | 'api' | 'connected_app' | 'system' | 'ai' required

Where the action originated from (app, admin, api, connected_app, system, ai)

ipstring nullable required

IP address of the actor

countrystring nullable required

Country code of the actor

user_agentstring nullable required

Browser user-agent string

created_atstring date-time required

When the action was performed

Example response

[
  {
    "connection": {
      "type": "SLACK"
    },
    "metadata": {
      "connection_type": "SLACK"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.