Update multiple observations at once

post

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

Allows for changing the status (e.g., active, archived) of multiple observations within a project simultaneously. Requires a list of observation 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 observation ids and the target status (e.g., 'active', 'archived') to apply to all of them.

Request body for bulk updating the status of multiple observations.

array of integers

required

length between 1 and 100

A list of observation unique numerical identifiers to be affected by a bulk operation.

id*

status

string

enum

required

Defaults to active

The current status of an observation in its lifecycle:

active: The observation is current, under consideration, or being actively discussed. This is the default for new observations.
archived: The observation has been reviewed and is no longer actively being pursued (e.g., deemed not actionable, superseded, or already addressed). It's kept for historical records. Knowledge Base: "Observations Feature Guide" - "Status Management".

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.