IDidealspot

Get the agent profile

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the facts an external coding agent needs before changing this app: the web framework and app type, the backend runtime, the scheduling pipeline, whether custom auth is enrolled, where Core integration calls may run, what the workspace plan allows, and the exact platform skill references to read for this app's shape. The references are the files Base44 publishes to the skills repository; install them with the install_command or read them from the repository directly.

Rate limit: 60 requests per minute per caller, shared across apps. Errors use the standard envelope {"error": {"code", "message", "details"}}.

get/api/apps/{app_id}/agent-profile

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/apps/{app_id}/agent-profile
  • Auth
    • HTTP bearer
    • or API key in header api_key
    • or HTTP bearer

Path parameters

app_idstring required

ID of the app whose sandbox to operate on.

Response

The app's profile and the skill references that apply to it.

app_idstring required

ID of the app.

app_typestring required

The platform's app type: user_app (web), mobile_app, user_game, slide, imported_app, user_agent, grow or user_workflows.

frameworkstring nullable required

Web framework the app was seeded with: vite_spa or tanstack_start (a game is a vite_spa app). null for mobile apps.

backend_runtimestring required

Generation of the runtime the app's backend functions run on: current, or legacy for apps not yet migrated. Only current apps have compiled skill references.

automation_pipelinestring required

Scheduling pipeline the app uses: workflows (the default) or legacy_automations for apps that predate workflows.

custom_auth_enrolledboolean required

Whether the app ships the custom-auth boilerplate (its own login pages) instead of the platform login.

core_integrationsstring required

Where base44.integrations.Core calls other than file uploads and signed URLs may run: backend_functions_only (the app has core-integration control, the default for new apps; the runtime rejects the call from client code) or client_allowed.

unsupported_reasonstring nullable required

Why no skill references are listed: app_type_not_supported or legacy_runtime_not_compiled. null when references are listed.

Example response

{
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "app_type": "user_app",
  "automation_pipeline": "workflows",
  "backend_runtime": "current",
  "core_integrations": "backend_functions_only",
  "custom_auth_enrolled": true,
  "entitlements": {
    "actors": true,
    "backend_functions": true,
    "workflows": true
  },
  "framework": "tanstack_start",
  "skills": {
    "install_command": "npx skills add base44/skills",
    "items": [
      {
        "capability": "entities",
        "path": "skills/base44-platform-entities/references/web.md"
      }
    ],
    "repository": "https://github.com/base44/skills",
    "variant": "web-tanstack"
  }
}

Changes