Intents

Create policy update intent

Changed on

Create an intent to update a policy. The intent must be authorized by the policy owner before it can be executed.

patch/v1/intents/policies/{policy_id}

Request

  • Base URL
    https://api.privy.io
  • Auth
    HTTP basic

Path parameters

policy_idstring required

ID of the policy.

Headers

privy-app-idstring required

ID of your Privy app.

privy-request-expirystring

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Request body

namestring

Name to assign to the policy, up to 100 characters.

owner_idstring cuid2 nullable

The key quorum ID to set as the owner of the resource. If you provide this, do not specify an owner.

Response

Created policy update intent.

intent_idstring required

Unique ID for the intent

created_by_display_namestring required

Display name of the user who created the intent

created_by_idstring

ID of the user who created the intent. If undefined, the intent was created using the app secret

created_atnumber required

Unix timestamp when the intent was created

resource_idstring required

ID of the resource being modified (wallet_id, policy_id, etc)

status'pending' | 'processing' | 'executed' | 'failed' | 'expired' | 'rejected' | 'dismissed' required

Current status of an intent.

custom_expiryboolean required

Whether this intent has a custom expiry time set by the client. If false, the intent expires after a default duration.

expires_atnumber required

Unix timestamp when the intent expires

rejected_atnumber

Unix timestamp when the intent was rejected, present when status is 'rejected'

dismissed_atnumber

Unix timestamp when the intent was dismissed, present when status is 'dismissed'

dismissal_reasonstring

Human-readable reason for dismissal, present when status is 'dismissed'

intent_type'POLICY' required

Changes

    • breaking

      removed subschema #4 from the request property anyOf list

    • info

      removed subschema #4 from the //// response property anyOf list for the response status

    • breaking

      the ///// response property's maxLength was unset from 24 for the response status

    11 more changes in this revision