cosigner

Create a new Cosigner

Create a cosigner and determine what it does on proposal, approval, and rejection.

post/v0/platform/cosigners

Request body

tagsstring[] required
namestring required
fallback_behavior'reject' | 'approve' | 'manual_review'

The outcome when a transaction passes the Blockaid detection engine but no configured policy matches.

  • reject - Rejects the transaction. Default.
  • approve - Approves the transaction.
  • manual_review - Sends the transaction to the Pending Transactions queue for manual review.

Response

Successful Response

tagsstring[] required
idstring required

The Cosigner's assigned unique ID.

namestring nullable required

The Cosigner name as defined upon creation.

status'pending' | 'ok' | 'error' required

The current status of the Cosigner.

  • ok - The Cosigner is active.
  • pending - The Cosigner is waiting for the final activation steps in the multisig wallet to be completed.
  • error - Something went wrong and the Cosigner is not working properly.
fallback_behavior'reject' | 'approve' | 'manual_review' required

The outcome when a transaction passes the Blockaid detection engine but no configured policy matches.

  • reject - Rejects the transaction. Default.
  • approve - Approves the transaction.
  • manual_review - Sends the transaction to the Pending Transactions queue for manual review.
errorstring nullable

If the Cosigner status is error, this field will show more information about the error.

created_atstring date-time required

The timestamp the Cosigner was created.

updated_atstring date-time required
updated_bystring nullable required

The user who last updated the Cosigner.

created_bystring required
selected_chainsstring[] nullable

Changes

Changed in 4 of the 95 revisions of this API.641771

  • 6941029c0ca92537See the full diff
    • removed the enum value advanced_control_policy of the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value advanced_control_policy of the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value advanced_control_policy of the request property data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value advanced_control_policy of the request property data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value advanced_control_policy of the request property data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value blockaid_ootb_policy of the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value blockaid_ootb_policy of the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value blockaid_ootb_policy of the request property data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value blockaid_ootb_policy of the request property data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy

      request-property-enum-value-removed

    • removed the enum value blockaid_ootb_policy of the request property data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy

      request-property-enum-value-removed

    • the data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy request property type/format changed from string/ to /

      request-property-type-changed

    • the data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy request property type/format changed from string/ to /

      request-property-type-changed

    • the data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy request property type/format changed from string/ to /

      request-property-type-changed

    • the data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy request property type/format changed from string/ to /

      request-property-type-changed

    • the data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy request property type/format changed from string/ to /

      request-property-type-changed

    • the response property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy became optional for the status 201

      response-property-became-optional

    • the response property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy became optional for the status 201

      response-property-became-optional

    • the response property data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy became optional for the status 201

      response-property-became-optional

    • the response property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy became optional for the status 201

      response-property-became-optional

    • the response property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy became optional for the status 201

      response-property-became-optional

    • the data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

    • the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

    • the data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

    • the data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

    • the data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy response's property type/format changed from string/ to / for status 201

      response-property-type-changed

    • added the new optional request property fallback_behavior

      new-optional-request-property

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy request property anyOf list

      request-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy request property anyOf list

      request-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy request property anyOf list

      request-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy request property anyOf list

      request-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy request property anyOf list

      request-property-any-of-added

    • the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy became optional

      request-property-became-optional

    • the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy became optional

      request-property-became-optional

    • the request property data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy became optional

      request-property-became-optional

    • the request property data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy became optional

      request-property-became-optional

    • the request property data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy became optional

      request-property-became-optional

    • request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy deprecated

      request-property-deprecated

    • request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy deprecated

      request-property-deprecated

    • request property data/oneOf[subschema #3: UtilaCosignerDataExternal]/security_policy deprecated

      request-property-deprecated

    • request property data/oneOf[subschema #4: CosignerSafeDataExternal]/security_policy deprecated

      request-property-deprecated

    • request property data/oneOf[subschema #5: CosignerSquadsDataExternal]/security_policy deprecated

      request-property-deprecated

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy response property anyOf list for the response status 201

      response-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy response property anyOf list for the response status 201

      response-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy response property anyOf list for the response status 201

      response-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy response property anyOf list for the response status 201

      response-property-any-of-added

    • added ExternalPolicyOption subschema #2 to the data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy response property anyOf list for the response status 201

      response-property-any-of-added

    • response property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy deprecated

      response-property-deprecated

    • response property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy deprecated

      response-property-deprecated

    • response property data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy deprecated

      response-property-deprecated

    • response property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy deprecated

      response-property-deprecated

    • response property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy deprecated

      response-property-deprecated

    • removed the advanced_control_policy enum value from the data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the advanced_control_policy enum value from the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the advanced_control_policy enum value from the data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the advanced_control_policy enum value from the data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the advanced_control_policy enum value from the data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the blockaid_ootb_policy enum value from the data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the blockaid_ootb_policy enum value from the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the blockaid_ootb_policy enum value from the data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the blockaid_ootb_policy enum value from the data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • removed the blockaid_ootb_policy enum value from the data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy response property for the response status 201

      response-property-enum-value-removed

    • added the required property fallback_behavior to the response with the 201 status

      response-required-property-added

    • the endpoint scheme security JWT was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 03ea93e2f608391731See the full diff
    • added the new required request property approval_actions/items/oneOf[subschema #2: SlackExternalAction]/channels

      new-required-request-property

    • added the new required request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/involvement_level

      new-required-request-property

    • added the new required request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_policy

      new-required-request-property

    • added the new required request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/unsupported_chain_behavior

      new-required-request-property

    • added the new required request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/involvement_level

      new-required-request-property

    • added the new required request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_policy

      new-required-request-property

    • added the new required request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/unsupported_chain_behavior

      new-required-request-property

    • added the new required request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/involvement_level

      new-required-request-property

    • added the new required request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/security_policy

      new-required-request-property

    • added the new required request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/wallet_address

      new-required-request-property

    • added the new required request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/involvement_level

      new-required-request-property

    • added the new required request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/security_policy

      new-required-request-property

    • added the new required request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/wallet_address

      new-required-request-property

    • added the new required request property malicious_actions/anyOf[subschema #1]/items/oneOf[subschema #2: SlackExternalAction]/channels

      new-required-request-property

    • added the new required request property proposal_actions/items/oneOf[subschema #2: SlackExternalAction]/channels

      new-required-request-property

    • added the new required request property rejection_actions/items/oneOf[subschema #2: SlackExternalAction]/channels

      new-required-request-property

    • the request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/override_address became required

      request-property-became-required

    • removed the enum value all_workspace of the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/scope

      request-property-enum-value-removed

    • response property updated_by list-of-types was widened by adding types null to media type application/json of response 201

      response-property-list-of-types-widened

    • removed the required property added_by from the response with the 201 status

      response-required-property-removed

    • removed the required property approval_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/signing_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/unsupported_chains_fallback_policy from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/signing_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/unsupported_chains_fallback_policy from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/safe_address from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/signing_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/signing_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/squads_address from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/signing_mode from the response with the 201 status

      response-required-property-removed

    • removed the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/unsupported_chains_fallback_policy from the response with the 201 status

      response-required-property-removed

    • removed the required property malicious_actions/anyOf[subschema #1]/items/oneOf[subschema #2: SlackExternalAction]/channel_ids from the response with the 201 status

      response-required-property-removed

    • removed the required property proposal_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids from the response with the 201 status

      response-required-property-removed

    • removed the required property rejection_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids from the response with the 201 status

      response-required-property-removed

    • removed the request property approval_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids

      request-property-removed

    • removed the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/security_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/signing_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/unsupported_chains_fallback_policy

      request-property-removed

    • removed the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/security_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/signing_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/unsupported_chains_fallback_policy

      request-property-removed

    • removed the request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/safe_address

      request-property-removed

    • removed the request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/security_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #3: CosignerSafeDataExternal -> subschema #4: CosignerSafeDataExternal]/signing_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/security_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/signing_mode

      request-property-removed

    • removed the request property data/oneOf[subschema #4: CosignerSquadsDataExternal -> subschema #5: CosignerSquadsDataExternal]/squads_address

      request-property-removed

    • removed the request property malicious_actions/anyOf[subschema #1]/items/oneOf[subschema #2: SlackExternalAction]/channel_ids

      request-property-removed

    • removed the request property proposal_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids

      request-property-removed

    • removed the request property rejection_actions/items/oneOf[subschema #2: SlackExternalAction]/channel_ids

      request-property-removed

    • added the new all_vaults enum value to the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/scope response property for the response status 201

      response-property-enum-value-added

    • added the new optional request property data/oneOf[subschema #1: FireblocksCosignerDataExternal]/chains

      new-optional-request-property

    • added the new optional request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/chains

      new-optional-request-property

    • added utila discriminator mapping keys to the data request property

      request-property-discriminator-mapping-added

    • added the new all_vaults enum value to the request property data/oneOf[subschema #2: FordefiCosignerDataExternal]/scope

      request-property-enum-value-added

    • added UtilaCosignerDataExternal to the data request property oneOf list

      request-property-one-of-added

    • added the optional property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/chains to the response with the 201 status

      response-optional-property-added

    • added the optional property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/chains to the response with the 201 status

      response-optional-property-added

    • added the optional property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/chains to the response with the 201 status

      response-optional-property-added

    • added the optional property selected_chains to the response with the 201 status

      response-optional-property-added

    • the response property data/oneOf[subschema #3: CosignerSafeResponseExternal]/override_address became required for the status 201

      response-property-became-required

    • removed the all_workspace enum value from the data/oneOf[subschema #2: FordefiCosignerResponseExternal]/scope response property for the response status 201

      response-property-enum-value-removed

    • added the required property approval_actions/items/oneOf[subschema #2: SlackExternalAction]/channels to the response with the 201 status

      response-required-property-added

    • added the required property created_by to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/involvement_level to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/unsupported_chain_behavior to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/involvement_level to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/security_policy to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #2: FordefiCosignerResponseExternal]/unsupported_chain_behavior to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/involvement_level to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/security_policy to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #3: CosignerSafeResponseExternal]/wallet_address to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/involvement_level to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/security_policy to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #4: CosignerSquadsResponseExternal]/wallet_address to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/involvement_level to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/security_policy to the response with the 201 status

      response-required-property-added

    • added the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/unsupported_chain_behavior to the response with the 201 status

      response-required-property-added

    • added the required property malicious_actions/anyOf[subschema #1]/items/oneOf[subschema #2: SlackExternalAction]/channels to the response with the 201 status

      response-required-property-added

    • added the required property proposal_actions/items/oneOf[subschema #2: SlackExternalAction]/channels to the response with the 201 status

      response-required-property-added

    • added the required property rejection_actions/items/oneOf[subschema #2: SlackExternalAction]/channels to the response with the 201 status

      response-required-property-added

    • added the new optional request property malicious_actions

      new-optional-request-property

    • added the optional property malicious_actions to the response with the 201 status

      response-optional-property-added

Of the 95 revisions, 1 has no diff computed.