Update an outcome | Close | Developer API Documentation

curl -X PUT https://api.close.com/api/v1/outcome/id/ \
     -H "Content-Type: application/json" \
     -u "<CLOSE_API_KEY>:" \
     -d '{
  "description": "Prospect is very interested and wants to proceed.",
  "name": "Very Interested"
}'

{
  "applies_to": [
    "calls",
    "meetings"
  ],
  "created_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "date_created": "2025-07-29T10:30:00.000000+00:00",
  "date_updated": "2025-07-29T11:45:00.000000+00:00",
  "description": "Prospect is very interested and wants to proceed",
  "id": "outcome_03oUxZfoO6e2vHmcz1DiHR",
  "name": "Very Interested",
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "type": "custom",
  "updated_by": "user_a6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA"
}

Update an existing outcome.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:)>.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Request

This endpoint expects an object.

descriptionstring or nullOptional

Explain what the outcome means and when it should be used.

namestring or nullOptional

Displayed to users wherever outcomes can be selected.

typeenum or nullOptional

Set to vm-dropped if this outcome should be automatically set on calls whenever a team member performs a Voicemail Drop. Otherwise, leave empty or explicitly set to custom (default).

Allowed values:

applies_tolist of enums or nullOptionalDeprecated

Deprecated. This field will be derived from type in a future update: custom applies to calls and meetings, vm-dropped applies to calls only.

Allowed values:

Response

Successful response

applies_tolist of enums

Allowed values:

created_bystring or null

date_createddatetime

date_updateddatetime

descriptionstring or null

idstring

namestring

organization_idstring

typeenum

Allowed values:

updated_bystring or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error