Update permissions

PATCH /admin/permission/update

Signature authentication & Bearer authentication & Drive authentication & Drive secret key & Guest authentication & Guest secret key

application/json

Body Required

id string(uuid)
account string
scopes array[object]
Hide scopes attributes Show scopes attributes object
- id integer(int64)
- scope string
  
  Values are USER, PROVIDER, ASSOCIATE_PROVIDER, BUSINESS, PAYMENT, SUPPORT, PRODUCT, ADMIN, or GUEST.
- permissions array[object]
  Hide permissions attributes Show permissions attributes object
  
  permission string
  
  Values are WRITE, READ, UPDATE, or DELETE.
  
  reason string
  
  id integer(int64)

Responses

200 */*

OK
Hide response attributes Show response attributes object
- status string
  
  Values are 100 CONTINUE, 101 SWITCHING_PROTOCOLS, 102 PROCESSING, 103 EARLY_HINTS, 103 CHECKPOINT, 200 OK, 201 CREATED, 202 ACCEPTED, 203 NON_AUTHORITATIVE_INFORMATION, 204 NO_CONTENT, 205 RESET_CONTENT, 206 PARTIAL_CONTENT, 207 MULTI_STATUS, 208 ALREADY_REPORTED, 226 IM_USED, 300 MULTIPLE_CHOICES, 301 MOVED_PERMANENTLY, 302 FOUND, 302 MOVED_TEMPORARILY, 303 SEE_OTHER, 304 NOT_MODIFIED, 305 USE_PROXY, 307 TEMPORARY_REDIRECT, 308 PERMANENT_REDIRECT, 400 BAD_REQUEST, 401 UNAUTHORIZED, 402 PAYMENT_REQUIRED, 403 FORBIDDEN, 404 NOT_FOUND, 405 METHOD_NOT_ALLOWED, 406 NOT_ACCEPTABLE, 407 PROXY_AUTHENTICATION_REQUIRED, 408 REQUEST_TIMEOUT, 409 CONFLICT, 410 GONE, 411 LENGTH_REQUIRED, 412 PRECONDITION_FAILED, 413 PAYLOAD_TOO_LARGE, 413 REQUEST_ENTITY_TOO_LARGE, 414 URI_TOO_LONG, 414 REQUEST_URI_TOO_LONG, 415 UNSUPPORTED_MEDIA_TYPE, 416 REQUESTED_RANGE_NOT_SATISFIABLE, 417 EXPECTATION_FAILED, 418 I_AM_A_TEAPOT, 419 INSUFFICIENT_SPACE_ON_RESOURCE, 420 METHOD_FAILURE, 421 DESTINATION_LOCKED, 422 UNPROCESSABLE_ENTITY, 423 LOCKED, 424 FAILED_DEPENDENCY, 425 TOO_EARLY, 426 UPGRADE_REQUIRED, 428 PRECONDITION_REQUIRED, 429 TOO_MANY_REQUESTS, 431 REQUEST_HEADER_FIELDS_TOO_LARGE, 451 UNAVAILABLE_FOR_LEGAL_REASONS, 500 INTERNAL_SERVER_ERROR, 501 NOT_IMPLEMENTED, 502 BAD_GATEWAY, 503 SERVICE_UNAVAILABLE, 504 GATEWAY_TIMEOUT, 505 HTTP_VERSION_NOT_SUPPORTED, 506 VARIANT_ALSO_NEGOTIATES, 507 INSUFFICIENT_STORAGE, 508 LOOP_DETECTED, 509 BANDWIDTH_LIMIT_EXCEEDED, 510 NOT_EXTENDED, or 511 NETWORK_AUTHENTICATION_REQUIRED.
- code integer(int32)
- message string
- data object
  
  Hide data attributes Show data attributes object
  
  role string
  
  Values are USER, PROVIDER, ASSOCIATE_PROVIDER, BUSINESS, SUPER_ADMIN, ADMIN, MANAGER, or TEAM.
  
  position string
  
  department string
  
  cluster array[object]
  
  Hide cluster attributes Show cluster attributes object
  
  id integer(int64)
  
  scope string
  
  Values are USER, PROVIDER, ASSOCIATE_PROVIDER, BUSINESS, PAYMENT, SUPPORT, PRODUCT, ADMIN, or GUEST.
  
  createdAt string
  
  updatedAt string
  
  permissions array[object]
  
  Hide permissions attributes Show permissions attributes object
  
  id integer(int64)
  
  createdAt string
  
  updatedAt string
  
  expiration string
  
  permission string
  
  Values are WRITE, READ, UPDATE, or DELETE.
  
  specific array[object]
  
  Hide specific attributes Show specific attributes object
  
  account string
  
  name string
  
  scopes array[object]
  
  Hide scopes attributes Show scopes attributes object
  
  id integer(int64)
  
  scope string
  
  Values are USER, PROVIDER, ASSOCIATE_PROVIDER, BUSINESS, PAYMENT, SUPPORT, PRODUCT, ADMIN, or GUEST.
  
  createdAt string
  
  updatedAt string
  
  permissions array[object]
  
  Hide permissions attributes Show permissions attributes object
  
  id integer(int64)
  
  createdAt string
  
  updatedAt string
  
  expiration string
  
  permission string
  
  Values are WRITE, READ, UPDATE, or DELETE.

PATCH /admin/permission/update

curl \
 --request PATCH 'https://sandbox.serchservice.com/api/v1/admin/permission/update' \
 --header "X-Serch-Signed: $API_KEY" \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-Serch-Drive-Api-Key: $API_KEY" \
 --header "X-Serch-Drive-Secret-Key: $API_KEY" \
 --header "X-Serch-Guest-Api-Key: $API_KEY" \
 --header "X-Serch-Guest-Secret-Key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"id":"string","account":"string","scopes":[{"id":42,"scope":"USER","permissions":[{"permission":"WRITE","reason":"string","id":42}]}]}'

Request examples

{
  "id": "string",
  "account": "string",
  "scopes": [
    {
      "id": 42,
      "scope": "USER",
      "permissions": [
        {
          "permission": "WRITE",
          "reason": "string",
          "id": 42
        }
      ]
    }
  ]
}

Response examples (200)

{
  "status": "100 CONTINUE",
  "code": 42,
  "message": "string",
  "data": {
    "role": "USER",
    "position": "string",
    "department": "string",
    "cluster": [
      {
        "id": 42,
        "scope": "USER",
        "createdAt": "string",
        "updatedAt": "string",
        "permissions": [
          {
            "id": 42,
            "createdAt": "string",
            "updatedAt": "string",
            "expiration": "string",
            "permission": "WRITE"
          }
        ]
      }
    ],
    "specific": [
      {
        "account": "string",
        "name": "string",
        "scopes": [
          {
            "id": 42,
            "scope": "USER",
            "createdAt": "string",
            "updatedAt": "string",
            "permissions": [
              {
                "id": 42,
                "createdAt": "string",
                "updatedAt": "string",
                "expiration": "string",
                "permission": "WRITE"
              }
            ]
          }
        ]
      }
    ]
  }
}