{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"name": "<string>",
"prompt": "<string>",
"model": "<string>",
"outputSchema": {
"type": "text",
"values": [
"<string>"
],
"provideExplanation": true,
"jsonSchema": "<string>"
},
"search": true,
"entity": "CONTACT",
"folderId": 123,
"customWebsiteField": "<string>",
"description": "<string>",
"isPublic": true,
"archivedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Update an AI variable
Update an existing AI variable (AI research). Prompt placeholders must come from the relevant fields endpoint output for this workspace; generic conversation placeholders such as previousMessage are not supported here.
When prompt is updated, Enginy regenerates the internal editor format from the new prompt text.
Use the contact/company fields endpoints as the source of truth for prompt placeholders. Do not assume campaign-only aliases like previousMessage are valid in manual/public AI-variable updates.
Required scope:
AI_VARIABLES_WRITERate limit: 30 requests per minute
{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"name": "<string>",
"prompt": "<string>",
"model": "<string>",
"outputSchema": {
"type": "text",
"values": [
"<string>"
],
"provideExplanation": true,
"jsonSchema": "<string>"
},
"search": true,
"entity": "CONTACT",
"folderId": 123,
"customWebsiteField": "<string>",
"description": "<string>",
"isPublic": true,
"archivedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Authorizations
Path Parameters
The AI variable ID
Body
New prompt template. Enginy regenerates the internal prompt representation from this value. Use GET /v1/contacts/fields or GET /v1/companies/fields to discover the valid placeholder names for this workspace. Unsupported generic placeholders such as {previousMessage} are rejected in manual/public AI-variable updates.
1Optional new model ID. One of the listed ids; enginy-default is recommended.
1"enginy-default"
Optional new output contract.
Show child attributes
Show child attributes
Enable or disable Deep Search.
Optional new entity.
CONTACT, COMPANY Optional new folder ID.
Optional new custom website field source.