EventType

A single event type in the Massdriver event catalog.

The id field follows dotted entity.action notation in past tense (e.g., project.cloned, deployment.completed).

type EventType {
  id: ID!
  description: String!
  entity: String!
  action: String!
  changeType: EventAction!
  metadata: [EventMetadataField!]!
}

Fields

EventType.id ● ID! non-null scalar {#id}

Dotted, past-tense event id, e.g., "environment.deployed" or "deployment.completed".

EventType.description ● String! non-null scalar {#description}

Human-readable summary of when this event fires and what its payload contains.

EventType.entity ● String! non-null scalar {#entity}

The entity this event applies to (e.g., "environment", "deployment", "instance").

EventType.action ● String! non-null scalar {#action}

Past-tense verb describing what happened to the entity (e.g., "created", "deployed"). Distinct from PolicyAction.verb, which is present-tense and describes what a principal may do.

EventType.changeType ● EventAction! non-null enum {#change-type}

How the entity was modified. Consumers use this for cache invalidation — CREATED / UPDATED / DELETED maps cleanly onto an in-memory cache's add / replace / remove.

EventType.metadata ● [EventMetadataField!]! non-null object {#metadata}

The metadata recorded with every event of this type. Every event records credential and, when an access token was used, access_token_id. Some event types record more, such as contains_secrets on resource.exported.

Returned By

eventTypes query