PUT
/
api
/
v2
/
ai-actions
/
{ai_action_id}
/

Partial updates are not currently supported.

Use the Get AI Action endpoint to get the action details first.

Authorizations

Authorization
string
headerrequired

Path Parameters

ai_action_id
string
required

ID of the action to update.

Query Parameters

account_id
integer

The Zapier account ID to use.

Account IDs available to the user can be listed using the Get Account List endpoint

authentication_id
integer | null

ID of the authentication to use for the app.

Authentications available to the user can be listed using the List Authentications For App endpoint.

Body

application/json
app
string
required
action
string
required
action_type
enum<string>
required
Available options:
read,
write,
search
params
object
required

Dictionary of need to value or list of possible values.

If this is a single string, then it will be used to guess the actual value of the need when running the action.

If this is a list of strings, it's expected that it will be IDs of possible values for the AI to choose from.

Needs that are omitted from this dictionary will be guessed by the AI at runtime based on instructions.

meta
object
required

Response

200 - application/json
id
string
required

The unique ID of the AI action.

description
string
required

Description of the AI action.

account_id
integer | null
required

Zapier account ID that will be used when running the action.

authentication_id
integer | null
required

ID of the authentication to use for the app when running the action.

app
string | null
required

The app that the action is for.

action
string | null
required

The action that will be run.

action_type
enum<string> | null
required

The type of action that will be run.

Available options:
read,
write,
search
params
object
required

The parameters that will be used when running the action.

meta
object
required

Metadata about the AI action.

needs
object[] | null