Update a Policy

Updates properties for a policy by ID.

Specify the policy ID in the policyId URI parameter.

m
You're not logged in. to run the demo.
put
https://api.ciscospark.com/v1/policies/{policyId}

Request Headers

Content-type application/json; charset=utf-8
Authorization
Bearer

Request Parameters

Name Type Description
appId string

The appId of the app the policy applies to.

name string

A user-friendly name for this policy.

personIds string[]

The personIds for the people this policy applies to.

scopes string[]

Scopes restricted by this policy.

action string

The policy action. Possible values: allow, deny.

Request Parameters

Name Type Your values
appId string
name string
personIds string[] Separate multiple values with commas
scopes string[] Separate multiple values with commas
action string

Response Codes

200

OK

400

The request was invalid or cannot be otherwise served. An accompanying error message will explain further.

401

Authentication credentials were missing or incorrect.

403

The request is understood, but it has been refused or access is not allowed.

404

The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.

409

The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.

429

Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.

500

Something went wrong on the server.

503

Server is overloaded with requests. Try again later.