PATCH
/api/v1/projects/<PROJECT_ID>/actions/<ACTION_ID>

Updates an existing action. Only provided fields are changed; omitted fields remain the same. The action ID cannot be modified.


Authentication

Request

  • Method: PATCH
  • URL: https://api.markerkit.com/v1/projects/<PROJECT_ID>/actions/<ACTION_ID>

Parameters

type
"modify-object""create-spot""create-poly""create-spots""create-polys"
Action type.
name string
Action name.
conditions Condition []
Trigger conditions. Default: [].
condition_operator
"and""or"
How to combine conditions.
object_id string
Target Object ID (for type="modify-object").
create_object_target_artboard_id string
Target artboard ID when creating objects.
create_object_name string
Name for created objects.
create_spot_x_source_type
"variable""custom"
X source type.
create_spot_x_custom_value string
Custom X (when source_type="custom").
create_spot_x_variable_id string
Variable ID for X (when source_type="variable").
create_spot_y_source_type
"variable""custom"
Y source type.
create_spot_y_custom_value string
Custom Y (when source_type="custom").
create_spot_y_variable_id string
Variable ID for Y (when source_type="variable").
create_poly_coords_variable_id string
Variable ID providing polygon coords.
style_color ObjectStyle
Color style.
style_opacity ObjectStyle
Opacity style.
style_stroke_color ObjectStyle
Stroke color style.
style_stroke_width ObjectStyle
Stroke width style.
style_stroke_opacity ObjectStyle
Stroke opacity style.
style_hover_color ObjectStyle
Hover color style.
style_hover_opacity ObjectStyle
Hover opacity style.
style_hover_stroke_color ObjectStyle
Hover stroke color style.
style_hover_stroke_width ObjectStyle
Hover stroke width style.
style_hover_stroke_opacity ObjectStyle
Hover stroke opacity style.
style_blend_mode ObjectStyle
Blend mode style.
style_radius ObjectStyle
Radius style.
style_pin ObjectStyle
Pin style.

Response

  • 200 OK: The updated Action object.
  • 400 Bad Request: Validation failed. Returns a formatted error message.
  • 401 Unauthorized: API key is missing or invalid.
  • 404 Not Found: Project or action not found, or not accessible by the user.
  • 500 Internal Server Error: Failed to update Action.

Example Request

Example Response