updateDecisionComponent

Update a decision component.

Operation

mutation UpdateDecisionComponent($input: UpdateDecisionComponentInput!) {
  updateDecisionComponent(input: $input) {
    decisionComponent {
      attachments {
        fileName
        id
        size
        uploadedDateTime
      }
      comments {
        content
        createdDateTime
        decisionComponent
        id
        updatedDateTime
      }
      hasAttachments
      hasComments
      id
      items {
        descriptiveText
        displayOrder
        guidance
        id
        label
        stakeholderId
        status
      }
      lastUpdatedBy {
        name
        type
      }
      schema {
        id
        label
        requiredRoles
        requiredScopes
      }
      status
      updatedDateTime
    }
    errors {
      ... on BadRequestError {
        advice
        code
        message
      }
      ... on ForbiddenError {
        advice
        code
        message
      }
      ... on InvalidActorError {
        advice
        code
        message
      }
      ... on InvalidOrganizationError {
        advice
        code
        message
      }
      ... on NotFoundError {
        advice
        code
        message
        resourceId
        resourceName
      }
      ... on ServerError {
        advice
        code
        message
      }
      ... on UnderwritingApplicationFieldValidationError {
        code
        field
        message
      }
      ... on UnderwritingApplicationStakeholderFieldValidationError {
        code
        field
        message
        stakeholderId
      }
      ... on UnderwritingApplicationValidationError {
        code
        message
      }
      ... on UnderwritingApplicationBankAccountFieldValidationError {
        bankAccountId
        code
        field
        message
      }
    }
  }
}

Response

{
  "data": {
    "updateDecisionComponent": {
      "decisionComponent": {
        "attachments": [
          {
            "fileName": "business-license.pdf",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "size": 0,
            "uploadedBy": "example",
            "uploadedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "comments": [
          {
            "content": "Approved for mechanical keyboard accessories line.",
            "createdBy": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "decisionComponent": "example",
            "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "lastUpdatedBy": "example",
            "updatedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "hasAttachments": true,
        "hasComments": true,
        "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "items": [
          {
            "descriptiveText": "example",
            "displayOrder": 0,
            "fields": [
              "example"
            ],
            "guidance": "example",
            "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
            "label": "example",
            "outcomes": "example",
            "stakeholderId": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "status": "ACCEPTED"
          }
        ],
        "lastUpdatedBy": {
          "name": "Ben Torres",
          "type": "APP"
        },
        "schema": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "label": "example",
          "requiredRoles": [
            "BANK"
          ],
          "requiredScopes": [
            "example"
          ],
          "underwritingDecisionComponentItemSchemas": [
            "example"
          ]
        },
        "status": "ACCEPTED",
        "updatedDateTime": "2026-01-15T14:30:00Z"
      },
      "errors": [
        {
          "__typename": "BadRequestError",
          "advice": "example",
          "code": "BAD_REQUEST",
          "message": "example"
        }
      ]
    }
  }
}

Mutation

Arguments

input · UpdateDecisionComponentInput! · required

Show child attributes

comments · [DecisionComponentCommentsInput!]

Comments to add to the decision component.

Show child attributes

addCommentsInput · AddDecisionComponentCommentsInput

Input for adding a new comment

Show child attributes

comment · String! · required

The comment text to add

decisionComponentId · UUID! · required

The unique identifier of the decision component to update.

fields · [UpdateDecisionComponentFieldInput!]

Decision component Field values to update.

Show child attributes

fieldId · UUID! · required

The unique identifier of the decision component field to update.

fieldValue · String

The updated value for this field.

status · DecisionComponentUpdatableStatus

The new status to set for the decision component.

Show Possible enum values

ACCEPTED · enum

The decision component has been accepted.

NOT_ACCEPTED · enum

The decision component has not been accepted.

Return type

UpdateDecisionComponentPayload!

decisionComponent · DecisionComponent

The decision component that was updated.

Show child attributes

attachments · [Attachment!]! · required

See Attachment

comments · [Comment!]! · required

See Comment

hasAttachments · Boolean! · required

hasComments · Boolean! · required

id · UUID! · required

The unique identifier of the decision component.

items · [DecisionComponentItem!]! · required

See DecisionComponentItem

lastUpdatedBy · Actor

The actor (user or app) who last updated this record

See Actor

schema · UnderwritingDecisionComponentSchema

See UnderwritingDecisionComponentSchema

status · DecisionComponentStatus

The current processing status of this decision component in the underwriting workflow.

See DecisionComponentStatus

updatedDateTime · DateTime! · required

The last date and time this was updated in UTC.

errors · [UpdateDecisionComponentError!]

Errors that occurred during the mutation, if any. Null or empty indicates success.

Show Possible types

Show BadRequestError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show ForbiddenError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show InvalidActorError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show InvalidOrganizationError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show NotFoundError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

resourceId · String

resourceName · String

Show ServerError

advice · String! · required

code · CommonErrorCode! · required

See CommonErrorCode

message · String! · required

Show UnderwritingApplicationFieldValidationError

Represents a field-level validation error on an underwriting application.

code · UnderwritingApplicationFieldValidationErrorCode! · required

A static code for tying the response back programmatically.

Show Possible enum values

FIELD_TOO_LONG · enum

A field value exceeds the maximum allowed length.

INVALID_BUSINESS_ADDRESS_COUNTRY_CODE · enum

The business address country code is not a recognized ISO 3166-1 alpha-3 value.

INVALID_EIN · enum

The Employer Identification Number (EIN) does not conform to the expected format of XX-XXXXXXX (e.g., 12-3456789).

INVALID_FIELD · enum

The field value does not meet the required format or constraints.

INVALID_MCC · enum

The Merchant Category Code (MCC) is not a recognized value.

INVALID_SSN · enum

The Social Security Number (SSN) does not conform to the expected format of XXX-XX-XXXX (e.g., 012-34-5678).

INVALID_TELEPHONE_NUMBER · enum

The telephone number is invalid. It must be a valid phone number containing only digits, with optional dashes, dots, or spaces.

INVALID_TIN · enum

The tax identification number (TIN) does not conform to the expected format: XXX-XX-XXXX for individuals (SSN/ITIN) or XX-XXXXXXX for businesses (EIN).

MISSING_FIELD · enum

A required field was not provided.

field · String! · required

The field that is invalid.

message · String! · required

A helpful message to help fix the invalid value.

Show UnderwritingApplicationStakeholderFieldValidationError

Represents a field-level validation error on a stakeholder within an underwriting application.

code · UnderwritingApplicationStakeholderFieldValidationErrorCode! · required

A static code for tying the response back programmatically

Show Possible enum values

FIELD_TOO_LONG · enum

A field value exceeds the maximum allowed length.

INVALID_FIELD · enum

The field value does not meet the required format or constraints.

INVALID_TELEPHONE_NUMBER · enum

The stakeholder’s telephone number is invalid. It must be a valid phone number containing only digits, with optional dashes, dots, or spaces.

MISSING_FIELD · enum

A required field was not provided.

field · String! · required

The field that is invalid

message · String! · required

A helpful message to help fix the invalid value

stakeholderId · UUID! · required

The associated stakeholder ID

Show UnderwritingApplicationValidationError

Represents a validation error on an underwriting application that is not specific to a single field.

code · UnderwritingApplicationValidationErrorCode! · required

A static code for tying the response back programmatically.

Show Possible enum values

INTERNAL_SERVER_ERROR · enum

An unexpected server error occurred while processing the application.

INVALID_OWNER · enum

The caller does not own the application or lacks permission to modify it.

INVALID_STATUS · enum

The application is in a state that does not permit this operation.

MISSING_GUARANTOR · enum

The application is missing a required guarantor.

message · String! · required

A helpful message to help fix the validation error.

Show UnderwritingApplicationBankAccountFieldValidationError

Represents a field-level validation error on a bank account within an underwriting application.

bankAccountId · UUID! · required

The associated bank account id

code · UnderwritingApplicationBankAccountFieldValidationGraphQlErrorCode! · required

A static code for tying the response back programmatically

Show Possible enum values

FIELD_TOO_LONG · enum

A field value exceeds the maximum allowed length.

INVALID_CHARACTERS · enum

A field contains characters that are not permitted.

MISSING_FIELD · enum

A required field was not provided.

field · String! · required

The field that is invalid

message · String! · required

A helpful message to help fix the invalid value

Operation

mutation UpdateDecisionComponent($input: UpdateDecisionComponentInput!) {
  updateDecisionComponent(input: $input) {
    decisionComponent {
      attachments {
        fileName
        id
        size
        uploadedDateTime
      }
      comments {
        content
        createdDateTime
        decisionComponent
        id
        updatedDateTime
      }
      hasAttachments
      hasComments
      id
      items {
        descriptiveText
        displayOrder
        guidance
        id
        label
        stakeholderId
        status
      }
      lastUpdatedBy {
        name
        type
      }
      schema {
        id
        label
        requiredRoles
        requiredScopes
      }
      status
      updatedDateTime
    }
    errors {
      ... on BadRequestError {
        advice
        code
        message
      }
      ... on ForbiddenError {
        advice
        code
        message
      }
      ... on InvalidActorError {
        advice
        code
        message
      }
      ... on InvalidOrganizationError {
        advice
        code
        message
      }
      ... on NotFoundError {
        advice
        code
        message
        resourceId
        resourceName
      }
      ... on ServerError {
        advice
        code
        message
      }
      ... on UnderwritingApplicationFieldValidationError {
        code
        field
        message
      }
      ... on UnderwritingApplicationStakeholderFieldValidationError {
        code
        field
        message
        stakeholderId
      }
      ... on UnderwritingApplicationValidationError {
        code
        message
      }
      ... on UnderwritingApplicationBankAccountFieldValidationError {
        bankAccountId
        code
        field
        message
      }
    }
  }
}

Response

{
  "data": {
    "updateDecisionComponent": {
      "decisionComponent": {
        "attachments": [
          {
            "fileName": "business-license.pdf",
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "size": 0,
            "uploadedBy": "example",
            "uploadedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "comments": [
          {
            "content": "Approved for mechanical keyboard accessories line.",
            "createdBy": "example",
            "createdDateTime": "2026-01-15T14:30:00Z",
            "decisionComponent": "example",
            "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "lastUpdatedBy": "example",
            "updatedDateTime": "2026-01-15T14:30:00Z"
          }
        ],
        "hasAttachments": true,
        "hasComments": true,
        "id": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
        "items": [
          {
            "descriptiveText": "example",
            "displayOrder": 0,
            "fields": [
              "example"
            ],
            "guidance": "example",
            "id": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
            "label": "example",
            "outcomes": "example",
            "stakeholderId": "b6d4e5f6-7a8b-9012-3def-456789012345",
            "status": "ACCEPTED"
          }
        ],
        "lastUpdatedBy": {
          "name": "Ben Torres",
          "type": "APP"
        },
        "schema": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "label": "example",
          "requiredRoles": [
            "BANK"
          ],
          "requiredScopes": [
            "example"
          ],
          "underwritingDecisionComponentItemSchemas": [
            "example"
          ]
        },
        "status": "ACCEPTED",
        "updatedDateTime": "2026-01-15T14:30:00Z"
      },
      "errors": [
        {
          "__typename": "BadRequestError",
          "advice": "example",
          "code": "BAD_REQUEST",
          "message": "example"
        }
      ]
    }
  }
}