Search Incidents with LinearB API on New Deploy Started from DeployHQ API

Pipedream makes it easy to connect APIs for LinearB, DeployHQ and 2,900+ other apps remarkably fast.

Trigger workflow on

New Deploy Started from the DeployHQ API

Next, do this

Search Incidents with the LinearB API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a DeployHQ trigger and LinearB action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Deploy Started trigger
1. Connect your DeployHQ account
Configure the Search Incidents action
1. Connect your LinearB account
2. Optional- Select one or more Teams
3. Optional- Select one or more Services
4. Optional- Configure Repository URLs
5. Optional- Configure Issued At Before
6. Optional- Configure Issued At After
7. Optional- Configure Started At
8. Optional- Configure Ended At
9. Optional- Select one or more Statuses
10. Optional- Configure Max Results
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Deploy Started on DeployHQ

Description:Emit new event when a deploy starts

Version:0.0.2

Key:deployhq-deploy-started

View on GitHub

DeployHQ Overview#

DeployHQ is a service that automates the deployment of your web applications. By integrating with version control systems, DeployHQ can automatically deploy code changes to various environments. Using the DeployHQ API on Pipedream, you can orchestrate deployments, manage your projects, and synchronize deployment activities with other tools in your toolchain. It opens up possibilities for custom deployment workflows, notifications, monitoring, and more, all connected within the Pipedream ecosystem.

Trigger Code#

import common, { STATUS_RUNNING } from "../common.mjs";

export default {
  ...common,
  key: "deployhq-deploy-started",
  name: "New Deploy Started",
  version: "0.0.2",
  description: "Emit new event when a deploy starts",
  type: "source",
  async run(request) {
    const { payload } = this.validateRequest(request);

    if (payload.status !== STATUS_RUNNING) {
      console.log(`Deploy status [${payload.status}] is not ${STATUS_RUNNING}`);
      return;
    }

    this.$emit({
      payload,
    }, {
      id: payload.identifier,
      summary: `Started ${payload.identifier}`,
      ts: Date.now(),
    });
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
DeployHQ	`deployHq`	`app`	This component uses the DeployHQ app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.

Trigger Authentication#

DeployHQ uses API keys for authentication. When you connect your DeployHQ account, Pipedream securely stores the keys so you can easily authenticate to DeployHQ APIs in both code and no-code steps.

DeployHQ requires their users enter their email, API Key, and account name in order to connect to their API. For more info, refer to DeployHQ’s documentation.

To retrieve your API key,

Navigate to your DeployHQ account and sign in
Go to “Settings” > “Security”

Your account name is 1234 if your DeployHQ URL is https://1234.deployhq.com

About DeployHQ#

Deployment made simple. We make it super easy to automate deploying projects from Git, SVN and Mercurial repositories.

Action#

Search Incidents on LinearB

Description:Search for incidents within the LinearB platform. [See the documentation](https://docs.linearb.io/api-incidents/#search-incidents)

Version:0.0.1

Key:linearb-search-incidents

View on GitHub

LinearB Overview#

The LinearB API serves as a bridge between LinearB's project management insights and your preferred platforms, offering the ability to automate workflows, generate reports, and trigger actions based on project metrics. With Pipedream, these capabilities can be harnessed to create custom workflows that respond to events within LinearB, such as changes in project status or team performance metrics. The data can be pushed to various services, such as communication tools, databases, or other project management apps to enhance visibility and coordination across your team.

Action Code#

import app from "../../linearb.app.mjs";

export default {
  key: "linearb-search-incidents",
  name: "Search Incidents",
  description: "Search for incidents within the LinearB platform. [See the documentation](https://docs.linearb.io/api-incidents/#search-incidents)",
  version: "0.0.1",
  type: "action",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  props: {
    app,
    teams: {
      propDefinition: [
        app,
        "teams",
      ],
      optional: true,
    },
    services: {
      propDefinition: [
        app,
        "services",
      ],
      optional: true,
    },
    repositoryUrls: {
      type: "string[]",
      label: "Repository URLs",
      description: "The list of repos urls related to this incident. **Lowercase only**",
      optional: true,
    },
    issuedAtBefore: {
      type: "string",
      label: "Issued At Before",
      description: "The specific date when the incident was logged and officially opened. (Format: `YYYY-MM-DD`)",
      optional: true,
    },
    issuedAtAfter: {
      type: "string",
      label: "Issued At After",
      description: "The specific date when the incident was logged and officially opened. (Format: `YYYY-MM-DD`)",
      optional: true,
    },
    startedAt: {
      type: "string",
      label: "Started At",
      description: "The specific date when work on the incident commenced. (Format: `YYYY-MM-DD`)",
      optional: true,
    },
    endedAt: {
      type: "string",
      label: "Ended At",
      description: "The specific date when the incident was successfully resolved. (Format: `YYYY-MM-DD`)",
      optional: true,
    },
    statuses: {
      type: "string[]",
      label: "Statuses",
      description: "A list of statuses of the incident",
      options: [
        "open",
        "in-progress",
        "closed",
        "deleted",
      ],
      optional: true,
    },
    maxResults: {
      type: "integer",
      label: "Max Results",
      description: "The maximum number of results to return",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.app.paginate({
      $,
      resourceFn: this.app.getIncidents,
      resourceName: "items",
      resourceFnArgs: {
        data: {
          issued_at: {
            before: this.issuedAtBefore,
            after: this.issuedAtAfter,
          },
          started_at: this.startedAt,
          ended_at: this.endedAt,
          statuses: this.statuses,
          teams: this.teams,
          services: this.services,
          repository_urls: this.repositoryUrls,
        },
      },
      max: this.maxResults,
    });

    $.export("$summary", `Successfully searched ${response.length} incident${response.length > 1
      ? "s"
      : ""}`);
    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
LinearB	`app`	`app`	This component uses the LinearB app.
Teams	`teams`	`string[]`	Select a value from the drop down menu.
Services	`services`	`string[]`	Select a value from the drop down menu.
Repository URLs	`repositoryUrls`	`string[]`	The list of repos urls related to this incident. Lowercase only
Issued At Before	`issuedAtBefore`	`string`	The specific date when the incident was logged and officially opened. (Format: `YYYY-MM-DD`)
Issued At After	`issuedAtAfter`	`string`	The specific date when the incident was logged and officially opened. (Format: `YYYY-MM-DD`)
Started At	`startedAt`	`string`	The specific date when work on the incident commenced. (Format: `YYYY-MM-DD`)
Ended At	`endedAt`	`string`	The specific date when the incident was successfully resolved. (Format: `YYYY-MM-DD`)
Statuses	`statuses`	`string[]`	Select a value from the drop down menu:`openin-progresscloseddeleted`
Max Results	`maxResults`	`integer`	The maximum number of results to return