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"
}

Field	Type	Description
`id`	string	Unique log entry identifier
`action`	string	The operation performed (see Available Actions)
`resourceType`	string	Type of resource affected (see Resource Types)
`resourceId`	string	ID of the affected resource
`actorType`	string	Who performed the action (`apiKey`)
`actorId`	string	ID of the actor (API key ID)
`organizationId`	string	Organization where the action occurred
`workspaceId`	string \| null	Workspace context, if applicable
`metadata`	object \| null	Action-specific context (e.g., workspace name, role changes)
`createdAt`	string	ISO 8601 timestamp

Query audit logs#

GET /v1/audit-logs

Query parameters:

Parameter	Type	Default	Description
`action`	string	—	Filter by action (e.g., `workspace.create`)
`resourceType`	string	—	Filter by resource type (e.g., `Workspace`)
`startDate`	string	—	ISO 8601 start date
`endDate`	string	—	ISO 8601 end date
`page`	integer	`1`	Page number
`perPage`	integer	`50`	Items 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#

Action	Description
`workspace.create`	Workspace created
`workspace.update`	Workspace name or settings updated
`workspace.updateProtection`	Deletion protection toggled
`workspace.clear`	All entities cleared from workspace

API key actions#

Action	Description
`apiKey.create`	API key created
`apiKey.update`	API key name updated
`apiKey.revoke`	API key revoked

Destination actions#

Action	Description
`destination.createWebhook`	Webhook destination created
`destination.createEmail`	Email destination created
`destination.update`	Destination configuration updated
`destination.delete`	Destination deleted
`destination.setEnabled`	Destination enabled or disabled

Member actions#

Action	Description
`member.update`	Member role updated
`member.delete`	Member removed from organization

Invitation actions#

Action	Description
`invitation.create`	Invitation sent
`invitation.delete`	Invitation cancelled
`invitation.resend`	Invitation re-sent

Collection actions#

Action	Description
`collection.create`	Collection created
`collection.update`	Collection updated
`collection.delete`	Collection deleted
`collection.share`	Collection shared with another organization

OAuth application actions#

Action	Description
`oauthApp.create`	OAuth application registered
`oauthApp.update`	OAuth application updated
`oauthApp.delete`	OAuth application deleted
`oauthApp.rotateSecret`	Client secret rotated

Organization actions#

Action	Description
`organization.update`	Organization settings updated
`organization.updateLocation`	Organization location updated

Workspace invitation actions#

Action	Description
`workspaceInvitation.create`	Workspace-scoped invitation created
`workspaceInvitation.cancel`	Workspace-scoped invitation cancelled

Resource types#

These are the resourceType values you can filter by:

Resource Type	Description
`Workspace`	Workspace resources
`ApiKey`	API key resources
`Destination`	Destination (webhook, email) resources
`Member`	Organization member resources
`Invitation`	Invitation resources
`Collection`	Collection resources
`OAuthApp`	OAuth application resources
`Organization`	Organization settings
`WorkspaceInvitation`	Workspace-scoped invitation resources