Intents

Create key quorum update intent

Changed on

Create an intent to update a key quorum. The intent must be authorized by the key quorum members before it can be executed.

patch/v1/intents/key_quorums/{key_quorum_id}

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/intents/key_quorums/{key_quorum_id}
  • Auth
    HTTP basic

Path parameters

key_quorum_idstring required

ID of the key quorum.

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

public_keysstring[]

List of P-256 public keys of the keys that should be authorized to sign on the key quorum, in base64-encoded DER format.

authorization_thresholdnumber

The number of keys that must sign for an action to be valid. Must be less than or equal to total number of key quorum members.

display_namestring
user_idsstring[]

List of user IDs of the users that should be authorized to sign on the key quorum.

key_quorum_idsstring[]

List of key quorum IDs that should be members of this key quorum. Key quorums can only be nested 1 level deep.

Response

Created key quorum 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'KEY_QUORUM' required

Example response

{
  "current_resource_data": {
    "id": "tb54eps4z44ed0jepousxi4n",
    "display_name": "Prod key quorum",
    "authorization_threshold": 1,
    "authorization_keys": [
      {
        "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEx4aoeD72yykviK+f/ckqE2CItVIG\n1rCnvC3/XZ1HgpOcMEMialRmTrqIK4oZlYd1RfxU3za/C9yjhboIuoPD3g==",
        "display_name": null
      },
      {
        "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErzZtQr/bMIh3Y8f9ZqseB9i/AfjQ\nhu+agbNqXcJy/TfoNqvc/Y3Mh7gIZ8ZLXQEykycx4mYSpqrxp1lBKqsZDQ==",
        "display_name": null
      }
    ],
    "user_ids": null
  },
  "action_result": {
    "response_body": {
      "id": "tb54eps4z44ed0jepousxi4n",
      "display_name": "Prod key quorum",
      "authorization_threshold": 1,
      "authorization_keys": [
        {
          "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEx4aoeD72yykviK+f/ckqE2CItVIG\n1rCnvC3/XZ1HgpOcMEMialRmTrqIK4oZlYd1RfxU3za/C9yjhboIuoPD3g==",
          "display_name": null
        },
        {
          "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErzZtQr/bMIh3Y8f9ZqseB9i/AfjQ\nhu+agbNqXcJy/TfoNqvc/Y3Mh7gIZ8ZLXQEykycx4mYSpqrxp1lBKqsZDQ==",
          "display_name": null
        }
      ],
      "user_ids": null
    },
    "prior_state": {
      "id": "tb54eps4z44ed0jepousxi4n",
      "display_name": "Prod key quorum",
      "authorization_threshold": 1,
      "authorization_keys": [
        {
          "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEx4aoeD72yykviK+f/ckqE2CItVIG\n1rCnvC3/XZ1HgpOcMEMialRmTrqIK4oZlYd1RfxU3za/C9yjhboIuoPD3g==",
          "display_name": null
        },
        {
          "public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErzZtQr/bMIh3Y8f9ZqseB9i/AfjQ\nhu+agbNqXcJy/TfoNqvc/Y3Mh7gIZ8ZLXQEykycx4mYSpqrxp1lBKqsZDQ==",
          "display_name": null
        }
      ],
      "user_ids": null
    }
  }
}

Changes

  • 527110c2c2f4Revision changes
    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • info

      added subschema #2 to the / response property allOf list for the response status

  • a8d27de9e15dRevision changes
    • breaking

      added to the //// response property oneOf list for the response status

    • info

      added discriminator to //// response property for the response status

    • info

      removed subschema #1: User member subschema #2: Key member subschema #3: Key quorum member from the //// response property oneOf list for the response status