Custom InstructionsCustom Instructions

Create a custom instruction

Create a new custom instruction for the AI Agent. New instructions default to inactive (enabled: false); enable one by setting enabled: true on create or via a later update.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
titlestringRequired1-150 characters

Display name for the custom instruction (unique per Agent)

textstringRequired1-300 characters

The instruction content — the rule the Agent should follow

enabledbooleanOptionalDefaults to false
Whether the instruction is enabled. False means inactive.
notesstringOptional

Internal notes about this instruction (not shown to the Agent)

availability_rulesstring or nullOptional

Optional availability rule as a rule-expression string with v("<variable_name>") lookups. Omit or send null for no rule. A rule that references an unknown variable, or that is malformed or uses an unsupported operator, is rejected with 400.

Response

Created
idstringRead-only
The unique identifier for the custom instruction
titlestring<=150 characters

Display name for the custom instruction (unique per Agent)

textstring<=300 characters

The instruction content — the rule the Agent should follow

enabledbooleanDefaults to false
Whether the instruction is enabled. False means inactive.
notesstring or null

Internal notes about this instruction (not shown to the Agent)

availability_rulesstring or null

Availability rule gating which end users this instruction applies to, as a rule-expression string with v("<variable_name>") variable lookups. null when no rule is set.

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error