Delete Multiple Projects

DELETE /projects/bulk/{ids} — Use this method to delete the project records with the specified internal IDs.

Parameters

Path parameters

Path parameter	Required / Optional	Description	Type
`{ids}`	Required	A comma-separated list of internal IDs for projects. The list must not include more than 100 project IDs.	integer

Path parameter

Required / Optional

Description

Type

{ids}

Required

A comma-separated list of internal IDs for projects. The list must not include more than 100 project IDs.

integer

Query string parameter

Path parameter	Required / Optional	Description	Type
`filterSetId`	Optional	The internal ID of the filter set to be applied. When specified, the request is successful only if the action is available when the specified filter set is active in SuiteProjects Pro. The filter set with the specified internal ID must exist and must be associated with the user who authorized the application as per the access token. Otherwise and by default, the primary filter set associated with the user who authorized the application is applied.	integer

Path parameter

Required / Optional

Description

Type

filterSetId

Optional

The internal ID of the filter set to be applied.

When specified, the request is successful only if the action is available when the specified filter set is active in SuiteProjects Pro. The filter set with the specified internal ID must exist and must be associated with the user who authorized the application as per the access token.
Otherwise and by default, the primary filter set associated with the user who authorized the application is applied.

integer

Response definitions

A successful or failed request returns a JSON object with the following properties:

Property	Description
`message`	A string containing a brief message about the status of your request — for example, `“Success”`. If your request includes multiple project IDs, both valid and invalid, the request will complete successfully for valid project IDs and return an error message for invalid project IDs — for example, `"Access to Project #372 denied"`. The response status will be `207 Multiple statuses returned`. If your request more than 100 project IDs, an error is returned — for example, `"Bulk action limit reached, sent 101 entities of 100 allowed"`.

Property

Description

message

A string containing a brief message about the status of your request — for example, “Success”.

If your request includes multiple project IDs, both valid and invalid, the request will complete successfully for valid project IDs and return an error message for invalid project IDs — for example, "Access to Project #372 denied". The response status will be 207 Multiple statuses returned.

If your request more than 100 project IDs, an error is returned — for example, "Bulk action limit reached, sent 101 entities of 100 allowed".

Sample request

            DELETE /rest/v1/projects/bulk/237,327,372 HTTP/1.1
Host: company-id.app.netsuitesuiteprojectspro.com
Authorization: Bearer <OAuth2_access_token>

In the example, <OAuth2_access_token> is the OAuth 2.0 access token obtained for the client application connecting to SuiteProjects Pro. See Authentication.

Sample response

            {
   "data": [
      {
         "1": {
            "data": [ {"id": "237"}],
            "message": "success"
         },
         "2": {
            "data": [ {"id": "327"}],
            "message": "success"
         },
         "3": {
            "data": [ {"id": "372"}],
            "message": "success"
         }
      }
   ],
   "message": "success"
}