Skip to main content
Custom API Calls allow the user to send a request to a specific endpoint if no action has been implemented for it. This will show in the actions list of the addon as Custom API Call, to enable this action for a addon, you need to call the createCustomApiCallAction in your actions array.

​
Basic Example

The example below implements the action for the OpenAI addon. The OpenAI addon uses a Bearer token authorization header to identify the user sending the request. 
actions: [
  ...yourActions,
  createCustomApiCallAction({
    // The auth object defined in the addon
    auth: openaiAuth,
    // The base URL for the API
    baseUrl: () => {
      'https://api.openai.com/v1'
    },
    // Mapping the auth object to the needed authorization headers
    authMapping: async (auth) => {
      return {
        'Authorization': `Bearer ${auth}`
      }
    }
  })
]

​
Dynamic Base URL and Basic Auth Example

The example below implements the action for the Jira Cloud addon. The Jira Cloud addon uses a dynamic base URL for it’s actions, where the base URL changes based on the values the user authenticated with. We will also implement a Basic authentication header. 
actions: [
  ...yourActions,
  createCustomApiCallAction({
    baseUrl: (auth) => {
      return `${(auth as JiraAuth).instanceUrl}/rest/api/3`
    },
    auth: jiraCloudAuth,
    authMapping: async (auth) => {
      const typedAuth = auth  as JiraAuth
      return {
        'Authorization': `Basic ${typedAuth.email}:${typedAuth.apiToken}`
      }
    }
  })
]