---
title: "Update Action"
method: PATCH
path: "/api/v1.0/actions/{id}"
tags: ["Actions"]
---

# Update Action

`PATCH /api/v1.0/actions/{id}`

## Path parameters

- `id` string, required

## Request body

- Action
  - `created_at` number — The date/time the Contact was created at represented as an integer
  - `id` integer — The ID of the Action.
  - `fulfilling_comment` Comment
    - `address` string — The address where the Comment was generated (this is automatically generated if latitude/longitude are specified)
    - `attachment_urls` object[] — An array of URLs to images attached to the Comment
      - `name` string — The UI name of the attachment
      - `url` string — The URL to access the attachment
      - `attachment_type` string — The file type of the attachment
    - `created_at` number — The date/time the Comment was created at represented as an integer
    - `disable_webhooks` boolean — Condition for deciding whether to disable webhook for the Comment
    - `external_id` string — An optional external Identifier to uniquely identify the Comment in integration systems
    - `fulfilled_action_id` integer — The ID of the action which this Comment fulfills
    - `id` number — The ID of the Comment
    - `text` string — The text of the Comment
    - `type` 'Comment' | 'PhoneCorrespondence' | 'EmailCorrespondence' | 'InpersonCorrespondence' | 'SocialCorrespondence' | 'ColdCorrespondence' — The type of Update
    - `latitude` number — The latitude coordinate the Comment was created at
    - `lead_id` string — The ID of the Lead the Comment is associated with
    - `longitude` number — The longitude coordinate the Comment was created at
    - `recording_url` string — A URL to an mp3 recording for the Comment
    - `user_id` integer — The ID of the user who created the Comment
  - `lead` Lead
    - `actioned_at` number — The date/time the last time a Lead was updated at represented as an integer
    - `address` string — The address of the Lead (auto-generated if latitude/longitude are specified)
    - `amount` number — Estimated value of the Lead
    - `campaign_id` integer — The ID of the Campaign the Lead was created on
    - `created_at` number — The date/time the Lead was created at represented as an integer
    - `custom_fields` object — A dictionary of Custom Field values with keys matching the Lead's Campaign Custom Field IDs
    - `description` string — A text description for the Lead
    - `disable_webhooks` boolean — Condition for deciding whether to disable webhook for the Lead
    - `geocoded_address` object
      - `street` string — The street address of the Lead
      - `city` string — The city of the Lead
      - `province` string — The Province/State of the Lead
      - `country` string — The Country of the Lead
      - `postal_code` string — The Zip/Postal Code of the Lead
    - `id` string — The ID of the Lead
    - `identifier` string — The name of the Lead, never null (if the Leads name is empty, it will provide a default string for the Lead)
    - `latitude` number — The latitude coordinate for the Lead's location
    - `longitude` number — The longitude coordinate for the Lead's location
    - `name` string — The name of the Lead
    - `owner_ids` integer[] — The array of IDs of Users who own the Lead
    - `photo_urls` string — An array of urls set associated with the Lead
    - `recording_url` string — A url to a mp3 file for a recorded description
    - `status` 'fresh' | 'received_by_sales' | 'work_in_progress' | 'pending_decision' | 'contract_signed' | 'completed' | 'failed' | 'hibernated' — The current status of the Lead in the Wingmate CRM Pipeline | OneOf("fresh", "received_by_sales", "work_in_progress", "pending_decision", "contract_signed", "completed", "failed", "hibernated")
    - `status_string` string — The name of the status matching the Campaign's lead_statuses field
    - `worker_id` integer — The ID of the user who generated the Lead
  - `text` string, required — The text of the action request
  - `user` User
    - `created_at` number — The date/time the User was created at represented as an integer
    - `email` string — The email of the User
    - `full_name` string — The name of the User
    - `has_admin_privileges` boolean — A boolean field representing whether the User can access the Admin Console or not
    - `id` string — The ID of the User
    - `password` string — The password of the User (auto-generated if left blank)
    - `phone_number` string — The phone number of the User
    - `profile_image_url` string — A URL pointing to the Users profile image
    - `receive_emails` boolean — A boolean field representing if the User receives emails from Wingmate or not
    - `receives_sms` boolean — A boolean field so that they receive SMS for your campaign (default is True)
    - `tag` string — A tag that other uses can use to mention the User in Comments and Reminders (this is automatically generated if left blank)
    - `time_zone` string — The time zone for the Users location
    - `title` string — The work title of the User
    - `type` 'Worker' | 'Salesperson' | 'Manager' — The type of User you wish to create | OneOf(Manager, Salesperson, Worker)
    - `uuid` unknown
  - `user_id` integer, required — The ID of the user who generated the action request

## Response `201`

Success

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/wingmateapp/apis/wingmate-api.md) · [All operations](https://skmtc.dev/wingmateapp/apis/wingmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wingmateapp/wingmate-api/revisions/d6fccce94b7c/schema)