This page contains the Project Authorized Groups and Project Authorized Users endpoints.


Project Authorized Groups

/organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groupss/

This endpoint allows you to manage project authorized groups.

Request Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer access_token
Host: example.org
Cookie: 

Request Example Format

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups" -d '{"group_id":767575238,"permission_delete":false,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":false}' -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer access_token" \
-H "Host: example.org" \
-H "Cookie: "

Request Parameters

Name Required/Optional Type Description
group_id Required integer ID of group
permission_delete Optional boolean Delete Permission
permission_download Optional boolean Download Permission
permission_make_folder Optional boolean Make Folder Permission
permission_rename Optional boolean Rename Permission
permission_upload Optional boolean Upload Permission
permission_view Optional boolean View Permission

Success Response Codes

Method Code
GET 200 OK
POST 201 Created
PUT 200 OK
DELETE 204 No Content

Error Response Codes

Description of error is included in response body.

Method Error Reason
POST 422 Unprocessable Entity Group has already been taken
PUT 422 Unprocessable Entity Submitted a parameter with an invalid or empty value

Response Attributes

Name Type Description
id integer ID for user resource
permission_delete boolean Delete Permission
permission_download boolean Download Permission
permission_make_folder boolean Make Folder Permission
permission_rename boolean Rename Permission
permission_upload boolean Upload Permission
permission_view boolean View Permission
group JSON object Object that contains the group ID

List all project authorized groups

GET /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groups

Request Example

curl -g "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups" -X GET

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
Link:
X-Pagination: {"total_count":1,"total_pages":1,"first_page":true,"last_page":true,"previous_page":null,"next_page":null}
ETag: W/"6416955dde01337dfc44e6ecd8c19bf3"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2a3cbd17-628b-434b-af85-30c7bf61cbc9
X-Runtime: 0.031638
Content-Length: 204

Success Response Example

200 OK
[
  {
    "id": 297825290,
    "permission_delete": false,
    "permission_download": false,
    "permission_make_folder": false,
    "permission_rename": false,
    "permission_upload": false,
    "permission_view": false,
    "group": {
      "id": 767575238
    }
  }
]


Show a specific project authorized group

GET /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groups/{id}

Request Example

curl -g "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups/297825290" -X GET

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"fc39f17f9a0205c474d7f9cf480d64c5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 5f1ff10a-73d8-4bca-a0c8-bacd146583f1
X-Runtime: 0.028317
Content-Length: 202

Success Response Example

200 OK
{
  "id": 297825290,
  "permission_delete": false,
  "permission_download": false,
  "permission_make_folder": false,
  "permission_rename": false,
  "permission_upload": false,
  "permission_view": false,
  "group": {
    "id": 767575238
  }
}


Authorize a group as a project authorized group

POST /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groups

Request Example

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups" -d '{"group_id":767575238,"permission_delete":false,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":false}' -X POST

Response Headers

X-Frame-Options: SAMEORIGIN
  X-XSS-Protection: 1; mode=block
  X-Content-Type-Options: nosniff
  Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
  Content-Type: application/json; charset=utf-8
  ETag: W/"7bc6622d0a9bcfcedf273109de8fb033"
  Cache-Control: max-age=0, private, must-revalidate
  X-Request-Id: 05b14c37-2399-43f4-b3bf-e6706cd4baef
  X-Runtime: 0.061569
  Content-Length: 202

Success Response Example

201 Created
{
  "id": 297825292,
  "permission_delete": false,
  "permission_download": false,
  "permission_make_folder": false,
  "permission_rename": false,
  "permission_upload": false,
  "permission_view": false,
  "group": {
    "id": 767575238
  }
  }

Error Response Example

422 Unprocessable Entity
{
      "errors": {
        "group": [
          "has already been taken"
        ]
      }
    }


Update a project authorized group's permissions

PUT /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groups/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups/297825290" -d '{"permission_delete":true,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":true}' -X PUT

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"50ac7cd63ed3f25743b967c3511bf3f0"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 9239e303-a1f1-47c0-9c50-1c9e5d92d890
X-Runtime: 0.034833
Content-Length: 200

Success Response Example

200 OK
{
  "id": 297825290,
  "permission_delete": true,
  "permission_download": false,
  "permission_make_folder": false,
  "permission_rename": false,
  "permission_upload": false,
  "permission_view": true,
  "group": {
    "id": 767575238
  }
}

Error Response Example

422 Unprocessable Entity
{
                "errors": {
                  "permission_view": [
                    "is not included in the list"
                  ]
                }
              }


Remove a project authorized group

DELETE /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_groups/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_groups/297825290" -d '' -X DELETE

Response Headers

X-Frame-Options: SAMEORIGIN
  X-XSS-Protection: 1; mode=block
  X-Content-Type-Options: nosniff
  Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
  Cache-Control: no-cache
  X-Request-Id: 861ce273-9619-4ca1-ab20-685f699c6560
  X-Runtime: 0.028416

Success Response Example

204 No Content


Project Authorized Users

/organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users

This endpoint allows you to manage project authorized users.

Request Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer access_token
Host: example.org
Cookie: 

Request Example Format

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_users" -d '{"user_id":830138774,"permission_delete":false,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":false}' -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer access_token" \
-H "Host: example.org" \
-H "Cookie: "

Request Parameters (POST and PUT)

Name Required/Optional Type Description
user_id Required integer ID of user
permission_delete Optional boolean Delete permission
permission_download Optional boolean Download permission
permission_make_folder Optional boolean Make folder permission
permission_rename Optional boolean Rename permission
permission_upload Optional boolean Upload permission
permission_view Optional boolean View permission

Success Response Codes

Method Code
GET 200 OK
POST 201 Created
PUT 200 OK
DELETE 204 No Content

Error Response Codes

Description of error is included in response body.

Method Error Reason
POST 422 Unprocessable Entity User has already been taken
PUT 422 Unprocessable Entity Submitted a parameter with an invalid or empty value

Response Attributes

Name Type Description
id string ID for user resource
permission_delete boolean Delete ermission
permission_download boolean Download permission
permission_make_folder boolean Permission to make folder
permission_rename boolean Rename ermission
permission_upload boolean Upload permission
permission_view boolean View permission
user JSON object Object that contains the user ID

List all project authorized users

GET /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users

Request Example

curl -g "http://shares.example.com/organizations/
            32400255/projects/800313582/settings/project_authorized_users" -X GET

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
Link: 
X-Pagination: {"total_count":1,"total_pages":1,"first_page":true,"last_page":true,"previous_page":null,"next_page":null}
ETag: W/"a743fa14866cda009045555f46eb9879"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: d93fe7f2-f2ed-4154-bb81-71a9e382a9dd
X-Runtime: 0.036868
Content-Length: 203

Success Response Example

200 OK
[
  {
    "id": 239586159,
    "permission_delete": false,
    "permission_download": false,
    "permission_make_folder": false,
    "permission_rename": false,
    "permission_upload": false,
    "permission_view": false,
    "user": {
      "id": 830138774
    }
  }
]

Get a specific project authorized user

GET /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users/{id}

Request Example

curl -g "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_users/239586159" -X GET

Response Headers

X-Frame-Options: SAMEORIGIN
    X-XSS-Protection: 1; mode=block
    X-Content-Type-Options: nosniff
    Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
    Content-Type: application/json; charset=utf-8
    ETag: W/"c7d6c5d996fc53670e964360bb73c5e3"
    Cache-Control: max-age=0, private, must-revalidate
    X-Request-Id: 31ae8c11-b6f2-4abd-a68b-d60e9fa939b8
    X-Runtime: 0.041926
    Content-Length: 201

Success Response Example

200 OK
{
      "id": 239586159,
      "permission_delete": false,
      "permission_download": false,
      "permission_make_folder": false,
      "permission_rename": false,
      "permission_upload": false,
      "permission_view": false,
      "user": {
        "id": 830138774
      }
    }


Authorize a user as a project authorized user

POST /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users

Request Example

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_users" -d '{"user_id":830138774,"permission_delete":false,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":false}' -X POST

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"49858d06eac5613298575829e7706321"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 0188ec1c-7581-452e-bbed-95e68ece46bf
X-Runtime: 0.061632
Content-Length: 201

Success Response Example

201 Created
{
  "id": 239586161,
  "permission_delete": false,
  "permission_download": false,
  "permission_make_folder": false,
  "permission_rename": false,
  "permission_upload": false,
  "permission_view": false,
  "user": {
    "id": 830138774
  }
}

Error Response Example

422 Unprocessable Entity
{
        "errors": {
          "user": [
            "has already been taken"
          ]
        }
      }


Update a project authorized user's permissions

PUT /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/projects/800313582/settings/project_authorized_users/239586159" -d '{"permission_delete":false,"permission_download":false,"permission_make_folder":false,"permission_rename":false,"permission_upload":false,"permission_view":true}' -X PUT

Response Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
Content-Type: application/json; charset=utf-8
ETag: W/"df6cb9e37ee1d11c536d63e1b186751b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 645d6726-bf55-4534-ac28-1b395318d753
X-Runtime: 0.031544
Content-Length: 200

Success Response Example

200 OK
{
  "id": 239586159,
  "permission_delete": false,
  "permission_download": false,
  "permission_make_folder": false,
  "permission_rename": false,
  "permission_upload": false,
  "permission_view": true,
  "user": {
    "id": 830138774
  }
}

Error Response Example

422 Unprocessable Entity
{
      "errors": {
        "permission_view": [
          "is not included in the list"
        ]
      }
    }


Remove a project authorized user from a project

DELETE /organizations/{organization_id}/projects/{project_id}/settings/project_authorized_users/{id}

Request Example

curl "http://shares.example.com/organizations/32400255/
            projects/800313582/settings/project_authorized_users/239586159" -d '' -X DELETE

Response Headers

X-Frame-Options: SAMEORIGIN
  X-XSS-Protection: 1; mode=block
  X-Content-Type-Options: nosniff
  Content-Security-Policy: script-src 'self' 'unsafe-inline' 'unsafe-eval' https://local.connectme.us https://d3gcli72yxqn2z.cloudfront.net http://d3gcli72yxqn2z.cloudfront.net
  Cache-Control: no-cache
  X-Request-Id: c8ac8ffd-f337-4a32-94f8-739ca0377468
  X-Runtime: 0.027295

Success Response Example

204 No Content

Video player

Video

×