Engagements

client.Prism.Objects.Engagements.New(ctx context.Context, params micro.PrismObjectEngagementNewParams) (*micro.PrismObjectEngagementNewResponse, error)

client.Prism.Objects.Engagements.Update(ctx context.Context, engagementID string, params micro.PrismObjectEngagementUpdateParams) (*micro.PrismObjectEngagementUpdateResponse, error)

client.Prism.Objects.Engagements.List(ctx context.Context, params micro.PrismObjectEngagementListParams) (*micro.PrismObjectEngagementListResponse, error)

client.Prism.Objects.Engagements.Delete(ctx context.Context, engagementID string, params micro.PrismObjectEngagementDeleteParams) error

client.Prism.Objects.Engagements.BulkNew(ctx context.Context, params micro.PrismObjectEngagementBulkNewParams) (*micro.PrismObjectEngagementBulkNewResponse, error)

client.Prism.Objects.Engagements.BulkDelete(ctx context.Context, params micro.PrismObjectEngagementBulkDeleteParams) (*micro.PrismObjectEngagementBulkDeleteResponse, error)

client.Prism.Objects.Engagements.BulkUpdate(ctx context.Context, params micro.PrismObjectEngagementBulkUpdateParams) (*micro.PrismObjectEngagementBulkUpdateResponse, error)

client.Prism.Objects.Engagements.Count(ctx context.Context, params micro.PrismObjectEngagementCountParams) (*micro.PrismObjectEngagementCountResponse, error)

client.Prism.Objects.Engagements.Duplicate(ctx context.Context, engagementID string, params micro.PrismObjectEngagementDuplicateParams) (*micro.PrismObjectEngagementDuplicateResponse, error)

client.Prism.Objects.Engagements.Find(ctx context.Context, slug string, value string, params micro.PrismObjectEngagementFindParams) (*micro.PrismObjectEngagementFindResponse, error)

client.Prism.Objects.Engagements.Get(ctx context.Context, engagementID string, params micro.PrismObjectEngagementGetParams) (*micro.PrismObjectEngagementGetResponse, error)

client.Prism.Objects.Engagements.Query(ctx context.Context, params micro.PrismObjectEngagementQueryParams) (*micro.PrismObjectEngagementQueryResponse, error)

client.Prism.Objects.Engagements.Restore(ctx context.Context, engagementID string, params micro.PrismObjectEngagementRestoreParams) (*micro.PrismObjectEngagementRestoreResponse, error)

client.Prism.Objects.Engagements.Upsert(ctx context.Context, slug string, value string, params micro.PrismObjectEngagementUpsertParams) (*micro.PrismObjectEngagementUpsertResponse, error)

type PrismObjectEngagementNewResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}               `json:"default"`
	List    interface{}                          `json:"list"`
	JSON    prismObjectEngagementNewResponseJSON `json:"-"`
}

type PrismObjectEngagementUpdateResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                  `json:"default"`
	List    interface{}                             `json:"list"`
	JSON    prismObjectEngagementUpdateResponseJSON `json:"-"`
}

type PrismObjectEngagementListResponse struct {
	Data []PrismObjectEngagementListResponseData `json:"data" api:"required"`
	// Accurate end-of-data signal — false on the last page, never forces clients to
	// overshoot.
	HasMore    bool   `json:"has_more" api:"required"`
	NextCursor string `json:"next_cursor" api:"nullable"`
	// Populated only when `?include_total=true` was passed.
	Total int64                                 `json:"total" api:"nullable"`
	JSON  prismObjectEngagementListResponseJSON `json:"-"`
}

type PrismObjectEngagementBulkNewResponse struct {
	// Null for sync imports (results inlined). Set for async imports.
	JobID  string                                     `json:"job_id" api:"required,nullable"`
	Status PrismObjectEngagementBulkNewResponseStatus `json:"status" api:"required"`
	// Total number of rows in the import.
	Total     int64     `json:"total" api:"required"`
	CreatedAt time.Time `json:"created_at" format:"date-time"`
	// Set when status=failed; describes the job-level failure (not per-row).
	Error     PrismObjectEngagementBulkNewResponseError `json:"error"`
	ExpiresAt time.Time                                 `json:"expires_at" format:"date-time"`
	Failed    int64                                     `json:"failed"`
	// Rows that have been attempted (succeeded + failed).
	Processed int64 `json:"processed"`
	// Per-row outcomes. Always present for sync imports; populated for async imports
	// once the job reaches `complete`.
	Results   []PrismObjectEngagementBulkNewResponseResult `json:"results"`
	Succeeded int64                                        `json:"succeeded"`
	UpdatedAt time.Time                                    `json:"updated_at" format:"date-time"`
	JSON      prismObjectEngagementBulkNewResponseJSON     `json:"-"`
}

type PrismObjectEngagementBulkDeleteResponse struct {
	Results []PrismObjectEngagementBulkDeleteResponseResult `json:"results" api:"required"`
	Summary PrismObjectEngagementBulkDeleteResponseSummary  `json:"summary" api:"required"`
	JSON    prismObjectEngagementBulkDeleteResponseJSON     `json:"-"`
}

type PrismObjectEngagementBulkUpdateResponse struct {
	Results []PrismObjectEngagementBulkUpdateResponseResult `json:"results" api:"required"`
	Summary PrismObjectEngagementBulkUpdateResponseSummary  `json:"summary" api:"required"`
	JSON    prismObjectEngagementBulkUpdateResponseJSON     `json:"-"`
}

type PrismObjectEngagementCountResponse struct {
	// Number of records matching the access scope.
	Total int64                                  `json:"total" api:"required"`
	JSON  prismObjectEngagementCountResponseJSON `json:"-"`
}

type PrismObjectEngagementDuplicateResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                     `json:"default"`
	List    interface{}                                `json:"list"`
	JSON    prismObjectEngagementDuplicateResponseJSON `json:"-"`
}

type PrismObjectEngagementFindResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                `json:"default"`
	List    interface{}                           `json:"list"`
	JSON    prismObjectEngagementFindResponseJSON `json:"-"`
}

type PrismObjectEngagementGetResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}               `json:"default"`
	List    interface{}                          `json:"list"`
	JSON    prismObjectEngagementGetResponseJSON `json:"-"`
}

type PrismObjectEngagementQueryResponse struct {
	Data []PrismObjectEngagementQueryResponseData `json:"data" api:"required"`
	// Accurate end-of-data signal. False when this page contains the last record; true
	// only when at least one more record exists. (Implementation note: the server
	// fetches one extra row internally to determine this — clients never need to
	// overshoot to discover the end.)
	HasMore bool `json:"has_more" api:"required"`
	// Opaque cursor pointing at the next page. Pass it back unchanged in the request
	// body (`cursor`) of the next call. Null when `has_more` is false.
	NextCursor string `json:"next_cursor" api:"nullable"`
	// Only populated when the request set `include_total: true`. Total number of
	// records matching the query, ignoring pagination. Opt-in because it costs an
	// additional pass over the result set.
	Total int64                                  `json:"total" api:"nullable"`
	JSON  prismObjectEngagementQueryResponseJSON `json:"-"`
}

type PrismObjectEngagementRestoreResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                   `json:"default"`
	List    interface{}                              `json:"list"`
	JSON    prismObjectEngagementRestoreResponseJSON `json:"-"`
}

type PrismObjectEngagementUpsertResponse struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                  `json:"default"`
	List    interface{}                             `json:"list"`
	JSON    prismObjectEngagementUpsertResponseJSON `json:"-"`
}

type PrismObjectEngagementNewParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID                param.Field[string]        `path:"teamId" api:"required" format:"uuid"`
	PrismObjectProperties PrismObjectPropertiesParam `json:"prism_object_properties" api:"required"`
	IdempotencyKey        param.Field[string]        `header:"Idempotency-Key"`
}

type PrismObjectEngagementUpdateParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID                param.Field[string]        `path:"teamId" api:"required" format:"uuid"`
	PrismObjectProperties PrismObjectPropertiesParam `json:"prism_object_properties" api:"required"`
	IdempotencyKey        param.Field[string]        `header:"Idempotency-Key"`
	IfMatch               param.Field[string]        `header:"If-Match"`
}

type PrismObjectEngagementListParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	// Opaque cursor from a previous response's `next_cursor`. Pass it back unchanged
	// to fetch the next page.
	Cursor param.Field[string] `query:"cursor"`
	// Include soft-deleted records. Pass the literal string `true`.
	Deleted param.Field[bool] `query:"deleted"`
	// When set to `true`, the response includes a `total` field with the unpaginated
	// row count. Costs an extra pass; prefer `GET .../count` for the unfiltered total.
	IncludeTotal param.Field[bool] `query:"include_total"`
	// Maximum number of rows to return. Capped server-side at 50.
	Limit param.Field[int64] `query:"limit"`
	// Scope properties to a specific list/app.
	ListID param.Field[string] `query:"list_id" format:"uuid"`
	// Comma-separated property slugs to return. Use dot notation for relationships.
	// `id` is always returned at the top level. Defaults to all properties.
	Select param.Field[string] `query:"select"`
	// Comma-separated list of slugs. Prefix with `-` for descending. Example:
	// `sort=-updated_at,name`.
	Sort param.Field[string] `query:"sort"`
}

type PrismObjectEngagementDeleteParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID  param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	IfMatch param.Field[string] `header:"If-Match"`
}

type PrismObjectEngagementBulkNewParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	// Array of objects to import with property values keyed by slug
	Objects        param.Field[[]PrismObjectPropertiesParam]              `json:"objects" api:"required"`
	Options        param.Field[PrismObjectEngagementBulkNewParamsOptions] `json:"options"`
	IdempotencyKey param.Field[string]                                    `header:"Idempotency-Key"`
}

type PrismObjectEngagementBulkDeleteParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID         param.Field[string]   `path:"teamId" api:"required" format:"uuid"`
	IDs            param.Field[[]string] `json:"ids" api:"required" format:"uuid"`
	IdempotencyKey param.Field[string]   `header:"Idempotency-Key"`
}

type PrismObjectEngagementBulkUpdateParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID         param.Field[string]                                      `path:"teamId" api:"required" format:"uuid"`
	Items          param.Field[[]PrismObjectEngagementBulkUpdateParamsItem] `json:"items" api:"required"`
	IdempotencyKey param.Field[string]                                      `header:"Idempotency-Key"`
}

type PrismObjectEngagementCountParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	// Scope the count to a specific list/app.
	ListID param.Field[string] `query:"list_id" format:"uuid"`
}

type PrismObjectEngagementDuplicateParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID         param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	IdempotencyKey param.Field[string] `header:"Idempotency-Key"`
}

type PrismObjectEngagementFindParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	// Scope the lookup to a specific list/app.
	ListID param.Field[string] `query:"list_id" format:"uuid"`
}

type PrismObjectEngagementGetParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	// Comma-separated property slugs to return. Use dot notation for relationships.
	// `id` is always returned at the top level. Defaults to all properties.
	Select param.Field[string] `query:"select"`
}

type PrismObjectEngagementQueryParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID param.Field[string]                                  `path:"teamId" api:"required" format:"uuid"`
	Query  param.Field[PrismObjectEngagementQueryParamsQuery]   `json:"query" api:"required"`
	ID     param.Field[PrismObjectEngagementQueryParamsIDUnion] `json:"id" format:"uuid"`
	Boxes  param.Field[[]string]                                `json:"boxes"`
	// Alternative location for the opaque cursor (a sibling of `query`). Use whichever
	// feels more natural; if both are present, `query.cursor` wins.
	Cursor  param.Field[string] `json:"cursor"`
	Deleted param.Field[bool]   `json:"deleted"`
	// When true, the response includes a `total` field with the unpaginated row count.
	// Costs an additional pass over the result set — for unfiltered totals prefer
	// `GET /v2/prism/{teamId}/{objectType}/count` instead.
	IncludeTotal param.Field[bool]     `json:"include_total"`
	Sources      param.Field[[]string] `json:"sources" format:"uuid"`
}

type PrismObjectEngagementRestoreParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID         param.Field[string] `path:"teamId" api:"required" format:"uuid"`
	IdempotencyKey param.Field[string] `header:"Idempotency-Key"`
}

type PrismObjectEngagementUpsertParams struct {
	// Use [option.WithTeamID] on the client to set a global default for this field.
	TeamID                param.Field[string]        `path:"teamId" api:"required" format:"uuid"`
	PrismObjectProperties PrismObjectPropertiesParam `json:"prism_object_properties" api:"required"`
	IdempotencyKey        param.Field[string]        `header:"Idempotency-Key"`
}

type PrismObjectEngagementListResponseData struct {
	ID           string `json:"id" api:"required" format:"uuid"`
	IsUserObject bool   `json:"is_user_object"`
	// Selected property values keyed by property slug. For select/multiselect
	// properties, option slugs are returned. For reference properties, values are
	// nested `{ id, properties }` objects.
	Properties map[string]interface{}                    `json:"properties"`
	Source     []string                                  `json:"source" api:"nullable"`
	JSON       prismObjectEngagementListResponseDataJSON `json:"-"`
}

type PrismObjectEngagementBulkNewResponseStatus string

type Error = apierror.Error

type PrismObjectEngagementBulkNewResponseError struct {
	Code    string                                        `json:"code"`
	Message string                                        `json:"message"`
	JSON    prismObjectEngagementBulkNewResponseErrorJSON `json:"-"`
}

type PrismObjectEngagementBulkNewResponseResult struct {
	ID      string                                           `json:"id" api:"nullable" format:"uuid"`
	Created bool                                             `json:"created"`
	Error   PrismObjectEngagementBulkNewResponseResultsError `json:"error"`
	// True if the row matched an existing record via the dedupe key.
	Existing bool                                           `json:"existing"`
	JSON     prismObjectEngagementBulkNewResponseResultJSON `json:"-"`
}

type PrismObjectEngagementBulkDeleteResponseResult struct {
	// Item ID, or null if the input was unparseable.
	ID     string                                               `json:"id" api:"required,nullable"`
	Status PrismObjectEngagementBulkDeleteResponseResultsStatus `json:"status" api:"required"`
	Error  PrismObjectEngagementBulkDeleteResponseResultsError  `json:"error"`
	// Object returned by reads (get/create/patch/restore). id is always present.
	Record PrismObjectEngagementBulkDeleteResponseResultsRecord `json:"record"`
	JSON   prismObjectEngagementBulkDeleteResponseResultJSON    `json:"-"`
}

type PrismObjectEngagementBulkDeleteResponseSummary struct {
	Failed    int64                                              `json:"failed" api:"required"`
	Succeeded int64                                              `json:"succeeded" api:"required"`
	Total     int64                                              `json:"total" api:"required"`
	JSON      prismObjectEngagementBulkDeleteResponseSummaryJSON `json:"-"`
}

type PrismObjectEngagementBulkUpdateResponseResult struct {
	// Item ID, or null if the input was unparseable.
	ID     string                                               `json:"id" api:"required,nullable"`
	Status PrismObjectEngagementBulkUpdateResponseResultsStatus `json:"status" api:"required"`
	Error  PrismObjectEngagementBulkUpdateResponseResultsError  `json:"error"`
	// Object returned by reads (get/create/patch/restore). id is always present.
	Record PrismObjectEngagementBulkUpdateResponseResultsRecord `json:"record"`
	JSON   prismObjectEngagementBulkUpdateResponseResultJSON    `json:"-"`
}

type PrismObjectEngagementBulkUpdateResponseSummary struct {
	Failed    int64                                              `json:"failed" api:"required"`
	Succeeded int64                                              `json:"succeeded" api:"required"`
	Total     int64                                              `json:"total" api:"required"`
	JSON      prismObjectEngagementBulkUpdateResponseSummaryJSON `json:"-"`
}

type PrismObjectEngagementQueryResponseData struct {
	ID           string `json:"id" api:"required" format:"uuid"`
	IsUserObject bool   `json:"is_user_object"`
	// Selected property values keyed by property slug. For select/multiselect
	// properties, option slugs are returned. For reference properties, values are
	// nested `{ id, properties }` objects.
	Properties map[string]interface{}                     `json:"properties"`
	Source     []string                                   `json:"source" api:"nullable"`
	JSON       prismObjectEngagementQueryResponseDataJSON `json:"-"`
}

type PrismObjectPropertiesParam struct {
	// Properties keyed by property slug. Values can be strings, numbers, booleans,
	// arrays, or null. For select/multiselect properties, values may be option slugs
	// or option UUIDs on write; option slugs are returned on read.
	Default param.Field[map[string]interface{}] `json:"default"`
	List    param.Field[interface{}]            `json:"list"`
}

type PrismObjectEngagementBulkNewParamsOptions struct {
	// Whether deduplication should be case insensitive
	CaseInsensitive param.Field[bool] `json:"caseInsensitive"`
	// Property slug to deduplicate on
	DedupeBy param.Field[string] `json:"dedupe_by"`
	// App/CRM ID for context (optional)
	ListID param.Field[string] `json:"list_id" format:"uuid"`
}

type PrismObjectEngagementBulkUpdateParamsItem struct {
	ID          param.Field[string]    `json:"id" api:"required" format:"uuid"`
	ExtraFields map[string]interface{} `json:"-,extras"`
}

type PrismObjectEngagementQueryParamsQuery struct {
	// Property slugs to select. Use dot notation for relationships (e.g.
	// attendee.contact.first_name). `id` is always returned at the top level of each
	// row and does not need to be selected.
	Select param.Field[[]string] `json:"select" api:"required"`
	// Logical operator for combining filters
	Combinator param.Field[PrismObjectEngagementQueryParamsQueryCombinator] `json:"combinator"`
	// Opaque cursor from a previous response's `next_cursor`. Pass it back unchanged
	// to fetch the next page. When set, `page` and `limit` are derived from the cursor
	// and any explicit values are ignored.
	Cursor param.Field[string] `json:"cursor"`
	// Filters as [{ slug: { operator: value } }]. For select/multiselect properties,
	// values may be option slugs or option UUIDs.
	Filter param.Field[[]map[string]PrismObjectEngagementQueryParamsQueryFilterUnion] `json:"filter"`
	// Maximum number of rows to return. Capped server-side at 50; requests above the
	// cap are rejected.
	Limit  param.Field[int64]  `json:"limit"`
	ListID param.Field[string] `json:"list_id" format:"uuid"`
	// Page number (1-based). Prefer `cursor`. Page-number pagination drifts under
	// concurrent writes; use it only for one-shot exports.
	//
	// Deprecated: deprecated
	Page param.Field[int64] `json:"page"`
	// Sort order as [{ slug: direction }]. Array order determines sort priority
	Sort param.Field[[]map[string]PrismObjectEngagementQueryParamsQuerySort] `json:"sort"`
}

type PrismObjectEngagementQueryParamsIDUnion interface {
	ImplementsPrismObjectEngagementQueryParamsIDUnion()
}

type PrismObjectEngagementBulkNewResponseResultsError struct {
	Code    string                                               `json:"code"`
	Message string                                               `json:"message"`
	JSON    prismObjectEngagementBulkNewResponseResultsErrorJSON `json:"-"`
}

type PrismObjectEngagementBulkDeleteResponseResultsStatus string

type PrismObjectEngagementBulkDeleteResponseResultsError struct {
	Code    string                                                  `json:"code"`
	Message string                                                  `json:"message"`
	JSON    prismObjectEngagementBulkDeleteResponseResultsErrorJSON `json:"-"`
}

type PrismObjectEngagementBulkDeleteResponseResultsRecord struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                                   `json:"default"`
	List    interface{}                                              `json:"list"`
	JSON    prismObjectEngagementBulkDeleteResponseResultsRecordJSON `json:"-"`
}

type PrismObjectEngagementBulkUpdateResponseResultsStatus string

type PrismObjectEngagementBulkUpdateResponseResultsError struct {
	Code    string                                                  `json:"code"`
	Message string                                                  `json:"message"`
	JSON    prismObjectEngagementBulkUpdateResponseResultsErrorJSON `json:"-"`
}

type PrismObjectEngagementBulkUpdateResponseResultsRecord struct {
	ID string `json:"id" api:"required" format:"uuid"`
	// Properties keyed by property slug.
	Default map[string]interface{}                                   `json:"default"`
	List    interface{}                                              `json:"list"`
	JSON    prismObjectEngagementBulkUpdateResponseResultsRecordJSON `json:"-"`
}

type PrismObjectEngagementQueryParamsQueryCombinator string

type PrismObjectEngagementQueryParamsQueryFilterUnion interface {
	implementsPrismObjectEngagementQueryParamsQueryFilterUnion()
}

type PrismObjectEngagementQueryParamsQuerySort string