Create connection between Apiary and Hive projects

To get information about Issues from Hive, it is necessary to set connection between Apiary and Hive projects.

Two types of connections are available:

App connection

With this type of connection all the projects created on Apiary are automatically created and synced with on Hive side.

To create App connection:

  1. Go to Admin > App connections.
  2. Click on Connect to Hive button:

  3. The system generates a .zip archive with unique configuration file in .yaml format in it. To create connection, upload this archive to Hive. See Hive connection.

After the connection is successful, you can create a Project:

  1. Click on + Project near the connection name:

  2. Select App Connection, specify the name of the Project and select the Project team members from Apiary side. Click Next

  3. Select Project Team members on Hive side - the list is pulled automatically from Hive. Click Save project

You can always click on the number near the App connection to see the list of all the projects created via this specific connection.


  • You can't add the existing projects to the App connection;

  • App connection cannot be paused, only removed;

  • If App connection is deleted, the connection between projects still remains.

Project connection

This connection is set between two individual projects.

There are two ways to create a direct connection between them:

  1. In Create project wizard select the option Project connection.


  1. In the Projects menu select your project in the list and click on next to it;
  2. In drop-down menu click Connect;

  3. In the Connect to Hive window enter Connection name and select the connection type:

    • New connection - generates a unique configuration file in .yaml format. To create connection, upload this file to the selected Hive project;
    • Link with existing - select this option to upload the existing configuration file in .yaml format to the Apiary project. You can get this file from Hive or use earlier generated files.
  4. Click Connect.

Now you can get information about issues from Hive projects.

When you set the connection, you will be able to communicate with pen-testing teams via issue Chat.

Note: each Issue has its own chat.

See also