API ReferenceReferenceApps
Create an app (draft)
Creates a new app as an unpublished draft. Requires the apps:write scope; a personal key also needs the member role or above. Edits change the DRAFT only: nothing reaches end users until POST …/publish.
Authorization
apiKey AuthorizationBearer <token>
An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/apps" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "app": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "slug": "string", "description": "string", "adviser": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "published": true }, "members": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "agent", "name": "string", "published": true, "position": 0 } ], "orchestrationMode": "string", "goals": "string", "adviserInstructions": "string", "api": { "conversationEnabled": true, "transactionEnabled": true, "greeting": "string", "inputSchema": {}, "outputSchema": {} }, "published": true, "productionVersionId": "a45124a6-f1ae-495a-9d4c-946315091da1", "versionCount": 0, "lastChange": { "at": "2019-08-24T14:15:22Z", "by": "string", "source": "ui", "action": "string", "summary": "string" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}