OMomni
Skills

Edit a skill

Changed on
<Note> This endpoint is currently in development and may change. </Note>

Updates an existing skill. Only included fields are updated.

patch/v1/skills/{skillId}

Request

  • Base URL
    https://blobsrus.omniapp.co/api
  • URL
    https://blobsrus.omniapp.co/api/v1/skills/{skillId}
  • Auth
    HTTP bearer

Path parameters

skillIdstring uuid required

Skill UUID

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Query parameters

userIdstring uuid

Requires an Organization API key. The membership ID of the user to attribute the action to.

Request body

bodystring

The instructions injected into the agent's context when the skill runs.

descriptionstring

What the skill is for. Shown in the skills list, and given to the agent when it chooses between skills.

identifierstring

Slash-command handle, stored without the slash. Lowercase letters, numbers and hyphens, starting with a letter or number.

namestring

A human-readable name for the skill.

Example request

{
  "body": "Pull revenue by month for the last four quarters, then...",
  "description": "Summarizes the quarter and flags anything off trend.",
  "identifier": "quarterly-report",
  "name": "Quarterly report"
}

Response

The updated skill

createdAtstring date-time required

ISO 8601 timestamp of when the skill was created

descriptionstring required

What the skill is for. Shown in the skills list, and given to the agent when it chooses between skills.

idstring uuid required

Unique identifier for the skill

identifierstring required

Slash-command handle, stored without the slash. Lowercase letters, numbers and hyphens, starting with a letter or number.

namestring required

A human-readable name for the skill.

updatedAtstring date-time required

ISO 8601 timestamp of the last time the skill was updated.

bodystring required

The instructions injected into the agent's context when the skill runs.

Example response

{
  "createdAt": "2026-01-15T10:00:00.000Z",
  "creator": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Blob Ross"
  },
  "description": "Summarizes the quarter and flags anything off trend.",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "identifier": "quarterly-report",
  "name": "Quarterly report",
  "updatedAt": "2026-02-01T09:30:00.000Z",
  "body": "Pull revenue by month for the last four quarters, then..."
}

Changes