Skip to main content
PATCH
/
integration
/
custom-instructions
/
{instructionId}
curl -X PATCH "https://api-integration.ollang.com/integration/custom-instructions/507f1f77bcf86cd799439011" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "Use informal tone for marketing copy only.",
    "active": true
  }'

{
  "id": "507f1f77bcf86cd799439011",
  "key": "tone_and_register",
  "value": "Use informal tone for marketing copy only.",
  "active": true,
  "description": "Instructions for maintaining appropriate tone and register",
  "scopeRefId": "507f1f77bcf86cd799439012",
  "createdAt": "2023-10-05T12:34:56.789Z",
  "updatedAt": "2023-10-06T09:15:00.000Z"
}
Update any combination of fields on a custom instruction. Send only the properties you want to change. 
curl -X PATCH "https://api-integration.ollang.com/integration/custom-instructions/507f1f77bcf86cd799439011" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "Use informal tone for marketing copy only.",
    "active": true
  }'

​
Authorizations

This endpoint requires API key authentication.

​
Path Parameters

​
instructionId
string
required
The custom instruction’s unique identifier (from List Custom Instructions or create response).

​
Body Parameters

All fields are optional; include at least one.
​
key
string
New machine-friendly name for the instruction.
​
value
string
New instruction text.
​
active
boolean
Enable or disable this instruction without deleting it.
​
description
string
Updated description.

​
Response

Returns the updated custom instruction object (same shape as List Custom Instructions). 
{
  "id": "507f1f77bcf86cd799439011",
  "key": "tone_and_register",
  "value": "Use informal tone for marketing copy only.",
  "active": true,
  "description": "Instructions for maintaining appropriate tone and register",
  "scopeRefId": "507f1f77bcf86cd799439012",
  "createdAt": "2023-10-05T12:34:56.789Z",
  "updatedAt": "2023-10-06T09:15:00.000Z"
}