---
title: "Add a broker resource URL"
method: POST
path: "/broker/apps/{broker_app_id}/resource-urls"
---

# Add a broker resource URL

`POST /broker/apps/{broker_app_id}/resource-urls`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/broker/apps/{broker_app_id}/resource-urls`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `broker:write`

Adds an internal resource URL that a broker app can access. Only base URLs are allowed, without a path (for example https://internal.resource.com). Resource URLs that point to another broker resource are not allowed.

## Path parameters

- `broker_app_id` integer, required

## Request body

- object
  - `internal_url` string, required: The internal base URL that the broker app should be able to access. Must be a valid URL without a path.

## Response `200`

The resource URL has been added

- object
  - `id` integer: The ID of the newly added resource URL
  - `broker_url` string: The public broker URL used to reach the internal resource
  - `internal_url` string: The internal base URL that the broker app can access

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)