---
tags:
  - xfer
---
# POST /api/xfer/inject/v1


!!! info
    This page was generated by extracting information from a JSON Schema
    data file for the API.  It may be missing some information, or otherwise
    suggest approximate or placeholder values based on information in the
    schema file; this is due to limitations on how that data is extracted
    from the underlying Rust code and into the JSON Schema, and then again
    from there and into these docs.

Performs a message transfer.
!!! warning
    This is considered to be an internal API and should not be
    used by external consumers.  It is intentionally under-specified
    in these auto-generated docs.

You probably want to look at the [/api/admin/xfer/v1](api_admin_xfer_v1_post.md)
endpoint which is used to request that a specific queue should
be re-routed via this XFER endpoint on the target node.

## Request Body

The request body is required.

The `Content-Type` header must be set to `text/plain`.


This is a string value.

### Examples
```json
"string"
```

## Responses
### Status 200
Message transferred successfully


`Content-Type: application/json`


This is an object value, with the following properties:


  * `id` - required [SpoolId](schemas/SpoolId.md). Identifies a message within the spool of its host node.

### Examples
```json
{
  "id": "d7ef132b5d7711eea8c8000c29c33806"
}
```
