Turn a skill on or off for a site
set_site_skill
Turns one skill on or off for a site.
Pick the skill by its id from list_site_skills. The change applies to the site's chat from the next message. Turning on a skill that is already on, or off one that is already off, succeeds without changing anything.
A site can have up to 10 skills on, so turning one more on is refused until another is turned off. A skill that belongs to another workspace is refused too. See Skills.
Request
Call it with a POST to https://api.modulify.ai/v1/set_site_skill, sending the inputs below as a JSON object. The token needs the config:write scope.
It makes changes, so send an Idempotency-Key header whenever you might retry it. A retry with the same key gets the first answer back instead of running again.
curl -X POST https://api.modulify.ai/v1/set_site_skill \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID","skillId":"SKILL_ID","enabled":true}'Over MCP, the same method is the set_site_skill tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
skillId |
string | Yes | The skill id from list_site_skills. |
enabled |
boolean | Yes | True to turn the skill on for the site, false to turn it off. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.