Skip to Content

Guides

Authentication House rules App checklist SDKs and tools Our apps

API

List shared with you GET List who has access GET List your shares GET Share files POST Unshare a file POST

Register an app GitHub put.io

API/Shares/List who has access

Register an app

List who has access

GEThttps://api.put.io/v2/files/{id}/shared-with

Each result item contains a share id which can be used for unsharing.

Path

idintegerRequired

File id

Returns

200

statusstring

shared-witharray

Errors

JSON with error_type, error_message, error_id and extra.

404File not found.

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

cURL

curl https://api.put.io/v2/files/{id}/shared-with \
  -H "Authorization: Bearer $TOKEN"

Response · 200

{
  "status": "OK",
  "shared-with": [
    {
      "user_name": "johndoe",
      "user_avatar_url": "https://avatars.put.io/v1/abc123.png",
      "share_id": 3913572317
    }
  ]
}

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.