Permissions

For Password Authentication, the user must have permission to view the record. Also, one of the following conditions must be met:

The user is the Assignee of the record

There are no Assignees set for the record

For API Token Authentication, the API Token must have permission to view the record. Also, one of the following conditions must be met:

The user "Administrator" is the Assignee of the record

There are no Assignees set for the record

Request Parameters

PARAMETER

VALUE

REQUIRED

DESCRIPTION

app

String

Yes

The App ID.

records

Array

Yes

An array including information of the record to be updated. Up to 100 records can be specified.

records[].action

String

Yes

The Action name of the action to run.

If the localization feature has been used to apply multiple translations of the Action name, specify the name of the Action in the language settings of the user that will run the API. API Tokens follow the language settings set in the Localization page of the User & System Administration settings.

records[].assignee

String

Optional

The next Assignee. Specify the Assignee's log in name.

records[].id

Integer

Yes

The Record ID.

records[].revision

Integer

Optional

The revision number of the record before updating the status. If the specified revision is not the latest revision, the request will result in an error. The revision will not be checked if this parameter is ignored, or -1 is specified.