Blueprints

Update a saved blueprint

Replace a saved template’s body. Pass the version you read as expectedVersion so a newer save is refused (STALE) rather than overwritten.

patch/v1/blueprints/{blueprintId}

Request

  • Base URL: https://api.banksync.io
  • URL: https://api.banksync.io/v1/blueprints/{blueprintId}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

blueprintIdstring required

Saved blueprint id, from the list

Headers

Idempotency-Keystring

Makes a retry safe: the same key with the same request replays the first answer for 24 hours instead of running twice, and the same key with a different request is a 409 IDEMPOTENCY_KEY_REUSED. Refusals a retry can outlive — 408, 409, 423, 425, 429 and every 5xx — are never replayed, so retrying with the same key after the cause clears runs the request.

Request body

blueprintobject

A portable blueprint (contract: "flagbase.blueprint/1", title, resources, inputs), as POST /blueprints/export or GET /blueprints/{blueprintId} answers it. It must carry no workspace ids.

visibility'private' | 'workspace'

Who sees it: private (only its owner, a signed-in member) or workspace (every member). Only the owner changes it.

expectedVersioninteger

The version you read: a newer save is refused (STALE) instead of overwritten

Response

The saved blueprint

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.