{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-miniapps/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Actions","description":"Developer API, partner integration, MCP, SDK, and customer help center.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"actions","__idx":0},"children":["Actions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Actions are API calls that users (or automations) can execute. Each action has a form for user input, one or more HTTP requests, and response mapping."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"defining-an-action","__idx":1},"children":["Defining an Action"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"actions: [\n  {\n    name: 'createIssue',              // Unique action identifier\n    title: 'Create Issue',            // Display title\n    description: 'Create a new issue in a repository',\n    renderStrategy: 'auto',           // UI rendering ('auto' = standard form)\n\n    // Form definition (JSON Schema)\n    parameters: { /* see §5.2 */ },\n\n    // HTTP requests to execute (see §5.3)\n    requests: [ /* ... */ ],\n  },\n]\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["renderStrategy"]}," values:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'auto'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard auto-generated form (recommended)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parameters-json-schema","__idx":2},"children":["Parameters (JSON Schema)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parameters define the user-facing form using ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://json-schema.org/"},"children":["JSON Schema"]},". Extended with custom ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-*"]}," properties for dynamic data."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"parameters: {\n  type: 'object',\n  required: ['repository', 'title'],\n  properties: {\n    // Simple text input\n    title: {\n      type: 'string',\n      title: 'Issue Title',\n      description: 'A short descriptive title',\n    },\n\n    // Text area (multiline)\n    body: {\n      type: 'string',\n      title: 'Description',\n    },\n\n    // Dynamic dropdown from RPC source\n    repository: {\n      type: 'string',\n      title: 'Repository',\n      'x-source': 'rpc_repos_list',   // References a source definition\n      'x-fallback': 'input',           // Fallback to text input if source fails\n    },\n\n    // Static dropdown (enum)\n    priority: {\n      type: 'string',\n      title: 'Priority',\n      enum: ['low', 'medium', 'high', 'critical'],\n      default: 'medium',\n    },\n\n    // Boolean toggle\n    isDraft: {\n      type: 'boolean',\n      title: 'Draft',\n      default: false,\n    },\n\n    // Number input\n    count: {\n      type: 'number',\n      title: 'Count',\n    },\n\n    // Array input (comma-separated or JSON)\n    labels: {\n      type: 'array',\n      title: 'Labels',\n    },\n  },\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," values:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Rendered As"},"children":["Rendered As"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Text input (or dropdown if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enum"]}," provided)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number input"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle switch"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Multi-value input"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nested form group"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom extensions:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Extension"},"children":["Extension"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RPC source key (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'rpc_channels_list'"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-fallback"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fallback mode if source fails (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'input'"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requests--chaining","__idx":3},"children":["Requests & Chaining"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each action has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]}," array. Requests execute ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sequentially"]}," — the response from request N is available as placeholders in request N+1."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"requests: [\n  {\n    url: 'https://api.example.com/issues',\n    method: 'POST',\n    headers: {\n      Authorization: 'Bearer [[accessToken]]',\n      'Content-Type': 'application/json',\n    },\n    bodyType: 'json',\n    body: {\n      title: '{{title}}',\n      body: '{{body}}',\n      labels: '{{labels}}',\n    },\n    mapping: {\n      issueId: '$.id',\n      issueUrl: '$.html_url',\n    },\n  },\n]\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chained requests"]}," (multi-step):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Example: Send a direct message on Slack\n// Step 1: Open a DM channel with the user\n// Step 2: Post a message to that channel\nrequests: [\n  // Step 1: Open DM channel\n  {\n    url: 'https://slack.com/api/conversations.open',\n    method: 'POST',\n    headers: {\n      Authorization: 'Bearer [[accessToken]]',\n      'Content-Type': 'application/json',\n    },\n    bodyType: 'json',\n    body: { users: '{{userId}}' },\n    // Array mapping → values forwarded to next request (NOT persisted)\n    mapping: [\n      { name: 'dmChannelId', value: '$.channel.id' },\n    ],\n  },\n\n  // Step 2: Post message (uses dmChannelId from step 1)\n  {\n    url: 'https://slack.com/api/chat.postMessage',\n    method: 'POST',\n    headers: {\n      Authorization: 'Bearer [[accessToken]]',\n      'Content-Type': 'application/json',\n    },\n    bodyType: 'json',\n    body: {\n      channel: '{{dmChannelId}}',    // ← From step 1's mapping\n      text: '{{messageText}}',       // ← From user's form input\n    },\n    mapping: {\n      messageTs: '$.ts',\n      channelId: '$.channel',\n    },\n  },\n]\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request fields:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full URL (supports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[[cred]]"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{param}}"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTP method: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request headers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryParams"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL query parameters"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bodyType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'json'"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'x-www-form-urlencoded'"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'formData'"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request body (placeholders replaced at runtime)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mapping"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object or array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Response extraction (see §5.5)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"placeholders","__idx":4},"children":["Placeholders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two placeholder syntaxes:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Syntax"},"children":["Syntax"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Source"},"children":["Source"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Persisted?"},"children":["Persisted?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[[key]]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credentials"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[[accessToken]]"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[[storeId]]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{key}}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User input + runtime context"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{channel}}"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{store_url}}"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Placeholder resolution order for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{key}}"]},":"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User's form input (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parameters"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Previous request's mapping output (in chained requests)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auth.config"]}," values (for registration requests)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["System-injected values (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookUrl"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subdomain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uid"]},")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type preservation:"]}," If a placeholder is the entire value (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body: { data: '{{myObject}}' }"]},"), the raw type is preserved — objects remain objects, arrays remain arrays. If a placeholder is part of a larger string (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Hello {{name}}!\""]},"), it's stringified."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-mapping","__idx":5},"children":["Response Mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mapping extracts values from API responses. Two formats with different behaviors:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Object mapping"]}," — Values are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["persisted"]}," in the database:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Auth step"},"children":["Auth step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Stored in"},"children":["Stored in"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_token"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refresh_token"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["registrationRequests"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InstalledMiniApps.credentials"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userDetails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["InstalledMiniApps.metadata"]}," (full mapping preserved)"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// get_token / refresh_token / registrationRequests → credentials\nmapping: {\n  accessToken: '$.access_token',\n  webhookId: '$.webhook.id',\n}\n\n// userDetails → metadata\nmapping: {\n  uid: '$.user.id',\n  storeId: '$.user.store.id',\n  storeName: '$.user.store.title',\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use object mapping in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_token"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refresh_token"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["registrationRequests"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["userDetails"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Array mapping"]}," — Values are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["forwarded to the next request"]}," only (not persisted):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"mapping: [\n  { name: 'channelId', value: '$.channel.id' },\n  { name: 'threadTs', value: '$.message.ts' },\n]\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use array mapping in action ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]}," when you need to chain request outputs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dot-path syntax:"]}," Values use JSONPath-like syntax starting with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Expression"},"children":["Expression"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$.id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Root-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$.data.user.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nested access"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$.items[0].code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Array index access"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$.channel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct field reference"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Actions","id":"actions","depth":1},{"value":"Defining an Action","id":"defining-an-action","depth":2},{"value":"Parameters (JSON Schema)","id":"parameters-json-schema","depth":2},{"value":"Requests & Chaining","id":"requests--chaining","depth":2},{"value":"Placeholders","id":"placeholders","depth":2},{"value":"Response Mapping","id":"response-mapping","depth":2}],"frontmatter":{"title":"Actions","titleTranslationKey":"sidebar.miniapps.actions","audience":"developer","status":"published","locales":["en"],"template":"GuidePage","seo":{"title":"Actions"}},"lastModified":"2026-06-23T12:06:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/miniapps/guides/actions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}