Transfers

Get Transfer

GET /api/apps/<app_id>/transfers/<transfer_id>/

URL params

Name	Description	Example
`app_id`	the app uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'
`transfer_id`	the transfer uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'

Successful status: 200 OK

Return the Transfer object.

Example:

JSON

{
    "id": "464631a5-a3fb-4e92-9ff1-20bdf2c3ad48",
    "component_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d.my_transfer12.Transfer.my_app3.vk_org",
    "attached_data": [
        {
            "key": "intent",
            "value": "Balance"
        },
        {
            "key": "authenticated",
            "value": "true"
        },
        {
            "key": "region",
            "value": "California"
        }
    ],
    "created_at": "2021-03-24T12:25:39.889640Z",
    "updated_at": "2021-03-24T12:25:39.889688Z",
    "user_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d",
    "group": "vk_org",
    "name": "my_transfer12",
    "target": "00012345",
    "reason": "Route out intent",
    "app": "ddc764ff-0e2a-4af0-a02e-6dd0b28d11b8"
}

Failed status: 404 NOT_FOUND

Create Transfer

POST /api/apps/<app_id>/transfers/

URL params

Name	Description	Example
`app_id`	the app uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'

Request payload

A Transfer object.

Name	Type	Default	Description	Required
`name`	string	-	transfer's name	yes
`target`	string	-	transfer's target	yes
`reason`	string	-	transfer's transfer reason	no
`attached_data`	array[Attached Data]	-	transfer's attached data	yes (the field must exist in the payload, but the list can be empty)

Example:

JSON

{
    "id": "464631a5-a3fb-4e92-9ff1-20bdf2c3ad48",
    "component_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d.my_transfer12.Transfer.my_app3.vk_org",
    "attached_data": [
        {
            "key": "intent",
            "value": "Balance"
        },
        {
            "key": "authenticated",
            "value": "true"
        },
        {
            "key": "region",
            "value": "California"
        }
    ],
    "created_at": "2021-03-24T12:25:39.889640Z",
    "updated_at": "2021-03-24T12:25:39.889688Z",
    "user_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d",
    "group": "vk_org",
    "name": "my_transfer12",
    "target": "00012345",
    "reason": "Route out intent",
    "app": "ddc764ff-0e2a-4af0-a02e-6dd0b28d11b8"
}

Successful status: 201 CREATED

The updated Transfer object.

Example:

JSON

{
    "id": "464631a5-a3fb-4e92-9ff1-20bdf2c3ad48",
    "component_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d.my_transfer12.Transfer.my_app3.vk_org",
    "attached_data": [
        {
            "key": "intent",
            "value": "Balance"
        },
        {
            "key": "authenticated",
            "value": "true"
        },
        {
            "key": "region",
            "value": "California"
        }
    ],
    "created_at": "2021-03-24T12:25:39.889640Z",
    "updated_at": "2021-03-24T12:25:39.889688Z",
    "user_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d",
    "group": "vk_org",
    "name": "my_transfer12",
    "target": "00012345",
    "reason": "Route out intent",
    "app": "ddc764ff-0e2a-4af0-a02e-6dd0b28d11b8"
}

Failed status: 400 BAD_REQUEST

when the transfer name contains invalid characters (acceptable characters are only alphanumeric [a-Z0-9] and the underscore character '_')
Example:
JSON
```
{
    "name": [
        "Invalid transfer name. Transfer name must contain only alphanumeric characters and the underscore character."
    ]
}
```
when the unique transfer name per application constraint is violated
Example:
JSON
```
[
    {
        "name": "Transfer with name and app already exists."
    }
]
```
when the group access privileges constraint is violated (the application is under a group to which the user does not have access privileges)
Example:
JSON
```
[
    {
        "name": "Application '<app_id>' is under the group '<group_name>' to which you do not have access privileges"
    }
]
```

Update Transfer

PUT /api/apps/<app_id>/transfers/<transfer_id>/

URL params

Name	Description	Example
`app_id`	the app uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'
`transfer_id`	the transfer uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'

Request payload

A Transfer object.

Name	Type	Description	Required
`target`	string	transfer's target	yes
`reason`	string	transfer's transfer reason	no
`attached_data`	array[Attached Data]	transfer's attached data	yes (the field must exist in the payload, but the list can be empty)

Example:

JSON

{
    "id": "464631a5-a3fb-4e92-9ff1-20bdf2c3ad48",
    "component_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d.my_transfer12.Transfer.my_app3.vk_org",
    "attached_data": [
        {
            "key": "intent",
            "value": "Balance"
        },
        {
            "key": "authenticated",
            "value": "true"
        },
        {
            "key": "region",
            "value": "California"
        }
    ],
    "created_at": "2021-03-24T12:25:39.889640Z",
    "updated_at": "2021-03-24T12:25:39.889688Z",
    "user_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d",
    "group": "vk_org",
    "name": "my_transfer12",
    "target": "00012345",
    "reason": "Route out intent",
    "app": "ddc764ff-0e2a-4af0-a02e-6dd0b28d11b8"
}

Successful status: 200 OK

Delete Transfer

DELETE /api/apps/<app_id>/transfers/<transfer_id>/

URL params

Name	Description	Example
`app_id`	the Application uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'
`transfer_id`	the transfer uuid	'930157b3-671c-4a81-a5d5-315fa63c6172'

Successful status: 204 NO_CONTENT

Failed status: 404 NOT_FOUND

Failed status: 409 CONFLICT

if Transfer is in use by other App/Flow

Example:

JSON

{
    "detail": "Cannot delete the Transfer, because it is used by these objects: test_app(app),test_flow(flow)"
}

Models

Transfer

Name	Type	Description
`name`	string	The transfer's name
`target`	string	The transfer's target
`reason`	string	The transfer's transfer reason
`attached_data`	array[Attached Data]	The transfer's attached data

Transfer.Attached Data

Name	Type	Description
`key`	string	The attached data name
`value`	string	The attached data value

Example:

JSON

{
    "id": "464631a5-a3fb-4e92-9ff1-20bdf2c3ad48",
    "component_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d.my_transfer12.Transfer.my_app3.vk_org",
    "attached_data": [
        {
            "key": "intent",
            "value": "Balance"
        },
        {
            "key": "authenticated",
            "value": "true"
        },
        {
            "key": "region",
            "value": "California"
        }
    ],
    "created_at": "2021-03-24T12:25:39.889640Z",
    "updated_at": "2021-03-24T12:25:39.889688Z",
    "user_id": "960d06c4-bdc9-4673-aef1-fbdf4ca1ae6d",
    "group": "vk_org",
    "name": "my_transfer12",
    "target": "00012345",
    "reason": "Route out intent",
    "app": "ddc764ff-0e2a-4af0-a02e-6dd0b28d11b8"
}