Update multiple goals at once

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/goals/bulk-update

Allows for changing the status (e.g., active, archived) of multiple goals within a project simultaneously. Requires a list of goal IDs and the target status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project to which save/retrieved data is connected

Body Params

Contains a list of goal ids and the target status (e.g., 'active', 'archived') to apply to all of them.

Request body for bulk updating the status of multiple goals.

array of integers

required

length between 1 and 100

The list of goals id to delete

id*

status

string

enum

required

The current status of a goal:

active: The goal is active and will track conversions for experiences it's attached to.
archived: The goal is archived and will not track new conversions. Its historical data remains accessible in reports for experiences that previously used it. Archived goals can often be cloned or unarchived. Knowledge Base: "Benefits of Archiving Unused Goals, Locations, and Audiences."

Allowed:

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Indicates the outcome of a bulk operation (e.g., bulk update or delete). Provides a general success message and an errors array listing any entities that could not be processed, along with the reason for failure for each.

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.