OMomniapp
Skills

Set a member's invocation mode for a skill

Changed on

Experimental. This resource is still gaining fields and may change without a version bump.

Sets the member's own invocation mode for a skill. It changes how that member's agent treats the skill and nothing else: other members keep their own mode. Any member who can view the skill can set theirs.

put/api/v1/skills/{skillId}/invocation-mode

Request

  • Base URL
    https://omniapp.co (the document declares no server; this is the origin it was published from)
  • URL
    https://omniapp.co/api/v1/skills/{skillId}/invocation-mode
  • Auth
    HTTP bearer

Path parameters

skillIdstring uuid required

Skill UUID

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Query parameters

userIdstring uuid

Target user ID (for org-scoped API keys)

Request body

invocationMode'auto' | 'manual' | 'off' required

When the member's agent may use the skill. auto: the agent may use the skill on its own, whenever a request fits. manual: only when the member asks for the skill by name or /identifier. off: the agent never runs it, and the chat menus leave it out. Turning a skill off doesn't change who can edit or delete it.

Example request

{
  "invocationMode": "manual"
}

Response

The mode now stored for the member

invocationMode'auto' | 'manual' | 'off' required

When the member's agent may use the skill. auto: the agent may use the skill on its own, whenever a request fits. manual: only when the member asks for the skill by name or /identifier. off: the agent never runs it, and the chat menus leave it out. Turning a skill off doesn't change who can edit or delete it.

skillIdstring uuid required

ID of the skill

Example response

{
  "invocationMode": "manual"
}

Changes