Skip to Content

Guides

Authentication House rules App checklist SDKs and tools Our apps

API

Approve a request POST Count requests received GET Deny a request POST Get a friend's folder GET List friends GET List requests received GET List requests sent GET Remove a friend POST Send a request POST

Register an app GitHub put.io

API/Friends/Send a request

Register an app

Send a request

POSThttps://api.put.io/v2/friends/{username}/request

Path

usernamestringRequired

Returns

200

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

400CANNOT_FRIEND_WITH_SELF, FRIEND_ALREADY_EXISTS or FRIEND_REQUEST_ALREADY_EXISTS

404USER_NOT_FOUND

429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.

cURL

curl -X POST https://api.put.io/v2/friends/{username}/request \
  -H "Authorization: Bearer $TOKEN"

Response · 200

{
  "status": "OK"
}

Shape from the spec. Values are placeholders.

The chat didn't load

Something in your browser may be blocking it. Email us at support@put.io instead.