cosigner

Get Cosigner External Route

Fetch a cosigner by ID.

get/v0/platform/cosigners/{id}

Path parameters

idstring required

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.31149

  • 6941029c0ca91021See the full diff
    • the response property data/oneOf[subschema #1: FireblocksCosignerResponseExternal]/security_policy became optional for the status 200

      response-property-became-optional

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

      response-property-became-optional

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

      response-property-became-optional

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

      response-property-became-optional

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

      response-property-became-optional

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

      response-property-type-changed

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

      response-property-type-changed

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

      response-property-type-changed

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

      response-property-type-changed

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

      response-property-type-changed

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

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      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 200

      response-property-enum-value-removed

    • added the required property fallback_behavior to the response with the 200 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

  • 03ea93e2f60821126See the full diff
    • response property updated_by list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

    • removed the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/unsupported_chains_fallback_policy from the response with the 200 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 200 status

      response-required-property-removed

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

      response-required-property-removed

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

      response-required-property-removed

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

      response-property-enum-value-added

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

      response-optional-property-added

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

      response-optional-property-added

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

      response-optional-property-added

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

      response-optional-property-added

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

      response-property-became-required

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

      response-property-enum-value-removed

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

    • added the required property data/oneOf[subschema #5: UtilaCosignerResponseExternal]/unsupported_chain_behavior to the response with the 200 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 200 status

      response-required-property-added

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

      response-required-property-added

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

      response-required-property-added

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

      response-optional-property-added

Of the 95 revisions, 1 has no diff computed.