---
updatedAt: 2026-01-14T16:39:08.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# authorization events

Post authorization events in real time.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Events",
    "version": "v1alpha1"
  },
  "webhooks": {
    "/webhooks/v1alpha1/authorizationEvents": {
      "post": {
        "summary": "authorization events",
        "description": "Post authorization events in real time.",
        "operationId": "Webhooks_AuthorizationEvents",
        "requestBody": {
          "description": "Webhook payload for authorization events, e.g. a user being permitted to read a resource.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AuthorizationEvent"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the event was received successfully."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Actor": {
        "type": "object",
        "required": [
          "type",
          "id",
          "name"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "The actor type.",
            "enum": [
              "USER",
              "GROUP"
            ]
          },
          "id": {
            "type": "string",
            "description": "Unique actor stripe id."
          },
          "name": {
            "type": "string",
            "description": "User or group name."
          }
        },
        "example": {
          "type": "USER",
          "id": "u_01JKPZ2GTCM",
          "name": "aoife@tamr.com"
        }
      },
      "AuthorizationEvent": {
        "type": "object",
        "required": [
          "id",
          "source",
          "time",
          "type",
          "specVersion",
          "dataContentType"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "CloudEvents unique id of the event."
          },
          "source": {
            "type": "string",
            "description": "CloudEvents uri-reference of the event."
          },
          "time": {
            "type": "string",
            "format": "date-time",
            "description": "CloudEvents time the event occurred (ISO 8601)."
          },
          "type": {
            "type": "string",
            "description": "CloudEvents type."
          },
          "specVersion": {
            "type": "string",
            "description": "CloudEvents specification version."
          },
          "dataContentType": {
            "type": "string",
            "description": "CloudEvents HTTP content type."
          },
          "data": {
            "$ref": "#/components/schemas/AuthorizationEventData",
            "description": "Event type-specific contents of the payload."
          }
        },
        "example": {
          "id": "3d8f82da-bf51-4d52-944a-11feb4ab333e",
          "source": "<tenant-subdomain>/webhooks/1273ced8-c07c-4a79-8d52-ee55573a639c",
          "time": "2025-10-23T16:22:11.453Z",
          "type": "tamr.api.v1alpha1.AuthorizationEvent",
          "specVersion": "1.0",
          "dataContentType": "application/json"
        }
      },
      "AuthorizationEventData": {
        "type": "object",
        "required": [
          "requestingUser",
          "permission",
          "targetResource",
          "allowed",
          "time"
        ],
        "properties": {
          "requestingUser": {
            "$ref": "#/components/schemas/Actor",
            "description": "The user requesting authorization (will always be of type USER)."
          },
          "permission": {
            "type": "string",
            "description": "The requested permission."
          },
          "targetResource": {
            "$ref": "#/components/schemas/Resource"
          },
          "allowed": {
            "type": "boolean",
            "description": "True if and only if the user was allowed the requested permission on the target resource."
          },
          "time": {
            "type": "string",
            "format": "date-time",
            "description": "The time the authorization occurred. RFC3339 UTC timestamp."
          }
        },
        "example": {
          "permission": "navigate.connections",
          "allowed": true,
          "time": "2025-10-20T22:14:28.177Z"
        }
      },
      "Resource": {
        "type": "object",
        "description": "Tamr Cloud resources.",
        "required": [
          "type",
          "id"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "The Tamr Cloud resource type.",
            "enum": [
              "TENANT",
              "USER",
              "CONNECTION",
              "GROUP",
              "PROJECT",
              "SOURCE",
              "DATA_PRODUCT"
            ]
          },
          "id": {
            "type": "string",
            "description": "Unique resource stripe id."
          },
          "name": {
            "type": "string",
            "description": "Optional. Resource name."
          },
          "displayName": {
            "type": "string",
            "description": "Optional. Resource display name."
          }
        },
        "example": {
          "type": "USER",
          "id": "u_01JKPZ2GTCMP12",
          "name": "aidanon@tamr.com",
          "displayName": "Aidan O'Neill"
        }
      }
    }
  }
}
```