Apps

Get all apps

get

Retrieve all apps for the authenticated user

Authorizations

AppAPIKey

x-app-api-keystringRequired

App API key in format:

Responses

200

Apps retrieved successfully

application/json

401

Unauthorized - invalid or missing API key

application/json

500

Internal server error

application/json

get/apps

HTTPcURLJavaScriptPython

GET /api/v1/apps HTTP/1.1
x-app-api-key: YOUR_API_KEY
Accept: */*

{
  "apps": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "apiKey": "text",
      "visibility": "PUBLIC",
      "createdAt": "2026-08-08T13:46:06.634Z",
      "updatedAt": "2026-08-08T13:46:06.634Z"
    }
  ]
}

Create a new app

post

Create a new app for the authenticated user

Authorizations

AppAPIKey

x-app-api-keystringRequired

App API key in format:

Body

application/json

namestring · min: 1 · max: 100Required

App name

descriptionstring · min: 1 · max: 500Required

App description

imageUrlstring · uriOptional

Optional image URL

visibilitystring · enumOptional

App visibility setting. PUBLIC apps are visible in public listings, PRIVATE apps are only accessible to the owner.

Default: PRIVATEPossible values:

Responses

201

App created successfully

application/json

idstringRequired

Unique app identifier

namestringRequired

App name

descriptionstringRequired

App description

imageUrlstring · nullableOptional

App image URL

apiKeystringRequired

App API key

visibilitystring · enumRequired

App visibility setting

Possible values:

createdAtstring · date-timeRequired

Creation timestamp

updatedAtstring · date-timeRequired

Last update timestamp

400

Invalid request data

application/json

401

Unauthorized - invalid or missing API key

application/json

500

Internal server error

application/json

post/apps

HTTPcURLJavaScriptPython

POST /api/v1/apps HTTP/1.1
x-app-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 92

{
  "name": "text",
  "description": "text",
  "imageUrl": "https://example.com",
  "visibility": "PRIVATE"
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "imageUrl": "text",
  "apiKey": "text",
  "visibility": "PUBLIC",
  "createdAt": "2026-08-08T13:46:06.634Z",
  "updatedAt": "2026-08-08T13:46:06.634Z"
}