OMomni
Skills

Create a skill

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

Creates a skill owned by the calling user.

post/v1/skills

Request

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

Request body

bodystring required

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

descriptionstring required

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

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.

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 created 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