# Invite people from the directory

Mints one invite link per address named, for addresses the connected directory actually holds, at the seat given or the workspace's configured default. Per address it answers what happened - invited, seated, invited_already or not_in_directory - so nothing is double-invited, and the links come back in `links`, the one and only place each token exists. Reach for it after reading the directory to let named people in.

Access class: `workspace:admin`.

## Endpoint

`POST /v1/workspace/directory/invite`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "addresses": [
      "string"
    ],
    "provider": "string",
    "role": "string"
  },
  "params": {},
  "query": {
    "provider": "string"
  }
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```