Generate Slack app manifest | Runtype Documentation

curl -X POST https://api.runtype.com/v1/integrations/slack/manifest \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "appName": "Runtype Slack Assistant",
  "surfaceId": "surface_123abc456def"
}'

{
  "createAppUrl": "https://slack.com/apps/manage/A1234567890/install",
  "eventsWebhookUrl": "https://api.runtype.com/v1/integrations/slack/events",
  "manifestJson": "{\"name\":\"Runtype Slack Assistant\",\"description\":\"Slack app for Runtype AI assistant integration.\",\"oauth_config\":{\"redirect_urls\":[\"https://api.runtype.com/v1/integrations/slack/oauth/start\"]},\"event_",
  "redirectUrl": "https://api.runtype.com/v1/integrations/slack/oauth/start",
  "interactivityWebhookUrl": "https://api.runtype.com/v1/integrations/slack/interactivity"
}

Generate the Slack app manifest and one-click create-app deep link for a surface, with absolute API URLs (events webhook, interactivity webhook, and OAuth redirect). The redirect URL matches the OAuth start route byte-for-byte.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

appNamestringRequired>=1 character

surfaceIdstringRequired>=1 character

includeAssistantFeaturesbooleanOptional

integrationIdstringOptional>=1 character

Response

Slack app manifest generated

createAppUrlstring

eventsWebhookUrlstring

manifestJsonstring

redirectUrlstring

interactivityWebhookUrlstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error