# ChangeSuggestion (/api/reference/objects/change-suggestion)

Something the AI read and proposes, in a sentence or two, for a person to accept, amend or dismiss. Nothing changes until they do. Accepting applies the change in the same write.

```graphql
type ChangeSuggestion {
  change: ChangeSuggestionChange!
  company: Company
  createdAt: DateTime!
  decidedAt: DateTime
  decidedBy: User
  evidence: [ChangeSuggestionEvidence!]!
  id: ID!
  kind: ChangeSuggestionKind!
  opportunity: Opportunity
  person: Person
  status: ChangeSuggestionStatus!
  text: String!
}
```

### Fields [#fields]

#### [`ChangeSuggestion.change`](#change) · [`ChangeSuggestionChange!`](/api/reference/objects/change-suggestion-change) `non-null` `object` [#change]
What it would change. Which parts are set follows `kind`.

#### [`ChangeSuggestion.company`](#company) · [`Company`](/api/reference/objects/company) `object` [#company]
The company it is about.

#### [`ChangeSuggestion.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When it was made.

#### [`ChangeSuggestion.decidedAt`](#decided-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#decided-at]
When it was decided.

#### [`ChangeSuggestion.decidedBy`](#decided-by) · [`User`](/api/reference/objects/user) `object` [#decided-by]
The member who decided it. Null while open, and when an automatic process decided, or they have left the workspace.

#### [`ChangeSuggestion.evidence`](#evidence) · [`[ChangeSuggestionEvidence!]!`](/api/reference/objects/change-suggestion-evidence) `non-null` `object` [#evidence]
The messages, calls and meetings it rests on. Empty when it rests on none.

#### [`ChangeSuggestion.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The suggestion's id.

#### [`ChangeSuggestion.kind`](#kind) · [`ChangeSuggestionKind!`](/api/reference/enums/change-suggestion-kind) `non-null` `enum` [#kind]
What kind of change it proposes.

#### [`ChangeSuggestion.opportunity`](#opportunity) · [`Opportunity`](/api/reference/objects/opportunity) `object` [#opportunity]
The opportunity it is about. After a `NEW_OPPORTUNITY` suggestion is accepted, the opportunity it opened.

#### [`ChangeSuggestion.person`](#person) · [`Person`](/api/reference/objects/person) `object` [#person]
The person it is about. After a `NEW_PERSON` suggestion is accepted, the person it found or added.

#### [`ChangeSuggestion.status`](#status) · [`ChangeSuggestionStatus!`](/api/reference/enums/change-suggestion-status) `non-null` `enum` [#status]
Whether it has been decided.

#### [`ChangeSuggestion.text`](#text) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#text]
What the person reads.

### Returned By [#returned-by]

[`changeSuggestion`](/api/reference/queries/change-suggestion)  `query`

### Member Of [#member-of]

[`AcceptChangeSuggestionPayload`](/api/reference/objects/accept-change-suggestion-payload)  `object` · [`ChangeSuggestionEdge`](/api/reference/objects/change-suggestion-edge)  `object` · [`CreateChangeSuggestionPayload`](/api/reference/objects/create-change-suggestion-payload)  `object` · [`DismissChangeSuggestionPayload`](/api/reference/objects/dismiss-change-suggestion-payload)  `object` · [`OpportunityStageEvent`](/api/reference/objects/opportunity-stage-event)  `object`