PUT
/
policies
/
{reference}
Update an authorization policy
curl --request PUT \
  --url https://api.smokeball.com/policies/{reference} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "principalId": "a7922e80-f833-48f0-8250-c00df1ebbc16",
  "resourceId": "matters/54171794-5ca3-472b-889a-c03538d8c89a",
  "rules": [
    {
      "principalId": "a7922e80-f833-48f0-8250-c00df1ebbc16",
      "resourceId": "matters/69406c65-309d-4e35-a636-ad145e64770a",
      "operation": "Access",
      "type": 0
    }
  ]
}'
{
  "id": "<string>",
  "href": "<string>",
  "relation": "<string>",
  "method": "GET"
}

Authorizations

​
x-api-key
string
header
required
​
Authorization
string
header
required

Path Parameters

​
reference
string
required

Body

​
principalId
string | null

Principal id associated to this policy if it is a principal based policy. This can be either a user id or a group id.

This is null if the policy is a resource based policy.

Example:

"a7922e80-f833-48f0-8250-c00df1ebbc16"

​
resourceId
string | null

Resource id associated to this policy if it is a resource based policy.

This is null if the policy is a principal based policy.

Example:

"matters/54171794-5ca3-472b-889a-c03538d8c89a"

​
rules
object[] | null

The rules associated to this policy.

Response

When request is accepted. Returns a hypermedia 'Link' object of the authorization policy to be updated.

​
id
string | null
​
href
string | null
​
relation
string | null
​
method
string | null
default:GET