---
title: "Issue a local tool connection request"
method: POST
path: "/localTools/connectionRequest/{broodId}/{localToolId}"
tags: ["LocalTools"]
---

# Issue a local tool connection request

`POST /localTools/connectionRequest/{broodId}/{localToolId}`

## Path parameters

- `broodId` integer, required
- `localToolId` integer, required

## Request body

- object
  - `local_tool_id` integer

## Response `200`

Incoming connection request inbox response

- IncomingConnectionRequestInbox
  - `id` integer
  - `uuid` string, uuid
  - `scope` 'User' | 'LocalTool' | 'Brood' | 'Proposal' | 'Synchronisation'
  - `action` 'Registration' | 'IncomingConnectionRequest' | 'AcceptedRequest' | 'DeclinedRequest' | 'Synchronisation' | 'OneWaySynchronization' | 'ProposalEdit' | 'DataExchange'
  - `title` string
  - `origin` string
  - `comment` string, nullable
  - `description` string, nullable
  - `user_id` integer
  - `created` string, datetime
  - `modified` string, datetime
  - `data` object
    - `connectorName` 'MispConnector', nullable
    - `cerebrateURL` string
    - `local_tool_id` integer
    - `remote_tool_id` integer

## Other responses

- `403` — Authentication failed. Please make sure you pass the API key of an API enabled user along in the Authorization header.
- `405` — Method not allowed. Your User Role is not allowed to access this resource.
- `default` — Unexpected API error

## Changes

- **2022-01-26** `c0b28bb67f40` — 1 info
  - endpoint added
- **2022-01-07** `75b84299e5fa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/changes/localTools/connectionRequest/:broodId/:localToolId/post.md)

---

[API](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api.md) · [All operations](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cerebrate-project/apis/cerebrate-project-api/revisions/50eb2c1b04b4?raw)