Apps

Get all apps

get

Retrieve all apps for the authenticated user

Authorizations

AppAPIKey

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
Host: 
x-app-api-key: YOUR_API_KEY
Accept: */*

{
  "apps": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "imageUrl": "text",
      "apiKey": "text",
      "visibility": "PUBLIC",
      "createdAt": "2025-10-31T04:50:53.014Z",
      "updatedAt": "2025-10-31T04:50:53.014Z"
    }
  ]
}

Create a new app

post

Create a new app for the authenticated user

Authorizations

AppAPIKey

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

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
Host: 
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": "2025-10-31T04:50:53.014Z",
  "updatedAt": "2025-10-31T04:50:53.014Z"
}