# Create a feed

Source: https://www.jawsdeploy.net/rest-api/feeds-create | Section: Feeds

Register a new external feed in a workspace.

`POST /api/feed`

Creates an external package feed. Creating the built-in `Jaws` feed type is not allowed.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `workspaceId` | body | string | yes | ID of the workspace. |
| `name` | body | string | yes | Display name. |
| `type` | body | string | yes | Feed type, e.g. `NuGet`. |
| `location` | body | string | yes | Feed URL. |
| `username` | body | string | no | Optional username. |
| `password` | body | string | no | Optional password / API key. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `workspaceId`, invalid `type`, or trying to create the built-in `Jaws` feed. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks the required role. |

Example request:

```
POST /api/feed

{ "workspaceId": "ws_abc", "name": "Acme NuGet", "type": "NuGet", "location": "https://nuget.acme.io/v3/index.json" }
```

Example response:

```
{ "feedId": "feed_1" }
```

