This resource is part of the v1alpha1 API and is subject to change. Fields and behavior may change in future releases.
Identity
| |
|---|
| Group | notification.miloapis.com |
| Version | v1alpha1 |
| Kind | Contact |
| Scope | Project |
Overview
A Contact represents a person who can receive notifications from Datum Cloud, tied to a user subject. Use it to register the name and email address that Datum Cloud (and its downstream notification providers) should use when reaching out to a user within a Project.
Spec fields
| Field | Type | Required | Description |
|---|
spec.email | string | Yes | The email address for the contact. |
spec.givenName | string | No | The contact’s given (first) name. |
spec.familyName | string | No | The contact’s family (last) name. |
spec.subject | Object | No | Reference to the subject the contact belongs to. |
spec.subject.apiGroup | string | Yes | API group of the referenced subject. Must be iam.miloapis.com. |
spec.subject.kind | string | Yes | Type of subject being referenced. Must be User. |
spec.subject.name | string | Yes | Name of the referenced subject. |
spec.subject.namespace | string | No | Namespace of the referenced subject. Required for Project-scoped subjects; omitted for Platform-scoped subjects. |
Status fields (read-only)
| Field | Type | Description |
|---|
status.conditions | []Object | Latest observations of the contact’s state. The standard Ready condition tracks contact creation and sync to the contact provider. |
status.providers | []Object | Per-provider status for this contact, enabling multiple provider backends to be tracked simultaneously. |
status.providerID | string | Identifier returned by the underlying contact provider (e.g. Resend) when the contact is created. Deprecated: use status.providers instead. |
Usage
apiVersion: notification.miloapis.com/v1alpha1
kind: Contact
metadata:
name: jane-doe
spec:
email: jane.doe@example.com
givenName: Jane
familyName: Doe
subject:
apiGroup: iam.miloapis.com
kind: User
name: jane-doe
datumctl apply -f contact.yaml --project my-project
datumctl get contacts --project my-project
datumctl describe contact jane-doe --project my-project
Run datumctl explain contacts --recursive to see the full, live field tree for this resource.
