Skip to main content
GET
/
v1
/
models
List models
curl --request GET \
  --url https://{instance}.omniapp.co/api/v1/models \
  --header 'Authorization: Bearer <token>'
{
  "records": [
    {}
  ],
  "pageInfo": {
    "hasNextPage": true,
    "nextCursor": "<string>",
    "pageSize": 123,
    "totalRecords": 123
  }
}

Authorizations

​
Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Query Parameters

​
baseModelId
string

Filter models by base model ID.

​
connectionId
string

Filter models by connection ID.

​
includeDeleted
boolean

If true, include deleted models.

​
modelId
string

Filter models by a specific model ID.

​
modelKind
enum<string>

Filter by model kind.

Available options:
SCHEMA,
SHARED,
SHARED_EXTENSION,
WORKBOOK,
BRANCH,
QUERY,
TOPIC,
FIELD_PICKER_TOPIC
​
name
string

Filter models by name.

​
pageSize
integer

Specifies the number of records per page.

​
cursor
string

Pagination cursor

​
sortDirection
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
​
sortField
enum<string>
default:updatedAt

Field to sort by.

Available options:
name,
modelKind,
connectionId,
baseModelId,
createdAt,
updatedAt
​
include
enum<string>

Additional fields to include

Available options:
activeBranches

Response

Paginated model list

​
records
object[]
​
pageInfo
object