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://api.slack.com/apps?new_app=1",
  "eventsWebhookUrl": "https://api.runtype.com/v1/integrations/slack/events/surface_123abc456def",
  "manifestJson": "{\n  \"display_information\": {\n    \"name\": \"Runtype Slack Assistant\",\n    \"description\": \"An AI assistant integration for Slack surfaces.\",\n    \"background_color\": \"#36C5F0\"\n  },\n  \"features\": {\n    \"sl",
  "redirectUrl": "https://api.runtype.com/v1/integrations/slack/oauth/start",
  "interactivityWebhookUrl": "https://api.runtype.com/v1/integrations/slack/interactivity/surface_123abc456def"
}

Generate the Slack app manifest for a surface, with absolute API URLs (events webhook, interactivity webhook, and OAuth redirect), plus a link to Slack’s app-creation page. Paste the manifest into Slack’s From a manifest option; Slack no longer accepts a manifest embedded in the URL. 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

interactivityWebhookUrlstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error