OMomni
Skills

List skills

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

List skills accessible to the calling user. If the caller is an Organization Admin, the response will include all skills in the organization; otherwise, only skills the caller created are returned.

get/v1/skills

Request

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

Query parameters

cursorstring
Example:eyJpZCI6IjEyMzQ1In0

Cursor for pagination from previous response nextCursor.

pageSizeinteger
Example:20

Number of results per page

sortDirection'asc' | 'desc'

Direction for sorting results:

  • asc - Ascending order (A-Z, 0-9)
  • desc - Descending order (Z-A, 9-0)
sortField'createdAt' | 'name' | 'updatedAt'

Field to sort results by

userIdstring uuid

Organization API key required. Target user membership ID.

creatorIdstring uuid

Filter by creator membership ID — creator.id from a listed skill, or your own membershipId from the Who am I? endpoint. Applies within what the caller can already see.

identifierstring
Example:quarterly-report

Filter to skills holding this handle.

qstring
Example:quarterly

Case-insensitive, free-text search over name, handle, and description. Can be used with identifier and creatorId to further refine results.

Response

Paginated list of skills

Example response

{
  "records": [
    {
      "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"
    }
  ]
}

Changes