# Report what became of a send

The sender says how one claimed message went — the outcome, the carrier's id, an error and how long to wait before retrying. Only the sender still holding the claim may report on it. The desktop rail's route, not a person's.

Access class: `workspace`.

## Endpoint

`POST /v1/comms/outbound/report`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "claimed_by": "string",
    "error": "string",
    "error_code": "string",
    "external_id": "",
    "message_id": 1,
    "outcome": "string",
    "provider": "string",
    "retry_after_seconds": 1
  },
  "params": {},
  "query": {}
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "status": "string"
}
```

### 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"
}
```
