Audit Logs

Every management operation is recorded in the audit log — who did what, when, and to which resource. Use the API to query these logs programmatically for compliance, security reviews, or operational debugging.

Tip

Prefer a visual interface? Audit logs are also browsable in the Texture Dashboard at Settings → Audit Log.


Audit log entry

{
  "id": "log_abc123def456",
  "action": "workspace.create",
  "resourceType": "Workspace",
  "resourceId": "ws_abc123def456",
  "actorType": "apiKey",
  "actorId": "key_abc123def456",
  "organizationId": "org_789xyz",
  "workspaceId": null,
  "metadata": {
    "workspaceName": "Production"
  },
  "createdAt": "2025-06-01T00:00:00.000Z"
}
FieldTypeDescription
idstringUnique log entry identifier
actionstringThe operation performed (see Available Actions)
resourceTypestringType of resource affected (see Resource Types)
resourceIdstringID of the affected resource
actorTypestringWho performed the action (apiKey)
actorIdstringID of the actor (API key ID)
organizationIdstringOrganization where the action occurred
workspaceIdstring | nullWorkspace context, if applicable
metadataobject | nullAction-specific context (e.g., workspace name, role changes)
createdAtstringISO 8601 timestamp

Query audit logs

GET /v1/audit-logs

Query parameters:

ParameterTypeDefaultDescription
actionstringFilter by action (e.g., workspace.create)
resourceTypestringFilter by resource type (e.g., Workspace)
startDatestringISO 8601 start date
endDatestringISO 8601 end date
pageinteger1Page number
perPageinteger50Items per page (max 100)

Response: 200 OK

{
  "data": [...],
  "meta": {
    "total": 156,
    "page": 1,
    "perPage": 50
  }
}

Example: recent workspace actions

curl "https://api.texturehq.com/v1/audit-logs?resourceType=Workspace&startDate=2025-06-01T00:00:00Z&perPage=10" \
  -H "Texture-Api-Key: management_abc123..."

Example: all actions in the last 24 hours

curl "https://api.texturehq.com/v1/audit-logs?startDate=$(date -u -v-1d +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Texture-Api-Key: management_abc123..."

Available actions

These are the action values you can filter by:

Workspace actions

ActionDescription
workspace.createWorkspace created
workspace.updateWorkspace name or settings updated
workspace.updateProtectionDeletion protection toggled
workspace.clearAll entities cleared from workspace

API key actions

ActionDescription
apiKey.createAPI key created
apiKey.updateAPI key name updated
apiKey.revokeAPI key revoked

Destination actions

ActionDescription
destination.createWebhookWebhook destination created
destination.createEmailEmail destination created
destination.updateDestination configuration updated
destination.deleteDestination deleted
destination.setEnabledDestination enabled or disabled

Member actions

ActionDescription
member.updateMember role updated
member.deleteMember removed from organization

Invitation actions

ActionDescription
invitation.createInvitation sent
invitation.deleteInvitation cancelled
invitation.resendInvitation re-sent

Collection actions

ActionDescription
collection.createCollection created
collection.updateCollection updated
collection.deleteCollection deleted
collection.shareCollection shared with another organization

OAuth application actions

ActionDescription
oauthApp.createOAuth application registered
oauthApp.updateOAuth application updated
oauthApp.deleteOAuth application deleted
oauthApp.rotateSecretClient secret rotated

Organization actions

ActionDescription
organization.updateOrganization settings updated
organization.updateLocationOrganization location updated

Workspace invitation actions

ActionDescription
workspaceInvitation.createWorkspace-scoped invitation created
workspaceInvitation.cancelWorkspace-scoped invitation cancelled

Resource types

These are the resourceType values you can filter by:

Resource TypeDescription
WorkspaceWorkspace resources
ApiKeyAPI key resources
DestinationDestination (webhook, email) resources
MemberOrganization member resources
InvitationInvitation resources
CollectionCollection resources
OAuthAppOAuth application resources
OrganizationOrganization settings
WorkspaceInvitationWorkspace-scoped invitation resources