from retab import Retab

client = Retab()

# Move + rename
block = client.workflows.blocks.update(
    block_id="extract-1",
    label="Extract Invoice Fields v2",
    position_x=480,
    position_y=160,
)

# Replace the config (e.g. tighten the schema, switch model)
block = client.workflows.blocks.update(
    block_id="extract-1",
    config={
        "model": "gpt-5-mini",
        "json_schema": {
            "type": "object",
            "properties": {
                "invoice_number": {"type": "string"},
                "total": {"type": "number"},
                "vendor": {
                    "type": "object",
                    "properties": {"name": {"type": "string"}}
                }
            },
        },
    },
)

import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

const block = await client.workflows.blocks.update("extract-1", "Extract Invoice Fields v2", 480, 160);

package main

import (
	"context"
	"fmt"
	"log"

	retab "github.com/retab-dev/retab/clients/go"
)

func ptr[T any](v T) *T { return &v }

func main() {
	ctx := context.Background()

	client, err := retab.NewClient("")
	if err != nil {
		log.Fatal(err)
	}

	label := "Extract Invoice Fields v2"
	positionX := 480.0
	positionY := 160.0

	block, err := client.Workflows.Blocks.Update(ctx, "extract-1", &retab.WorkflowBlocksUpdateParams{
		Label:     &label,
		PositionX: &positionX,
		PositionY: &positionY,
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(block.ID, block.Label)
}

require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

block = client.workflows.blocks.update(
  block_id: 'extract-1',
  label: 'Extract Invoice Fields v2',
  position_x: 480,
  position_y: 160,
)

puts "#{block.id} #{block.label}"

use retab::models::UpdateWorkflowBlockRequest;
use retab::resources::workflow_blocks::UpdateParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    let block = client
        .workflows().blocks()
        .update(
            "extract-1",
            UpdateParams::new(UpdateWorkflowBlockRequest {
                label: Some("Extract Invoice Fields v2".into()),
                position_x: Some(480.0),
                position_y: Some(160.0),
                ..Default::default()
            }),
        )
        .await?;

    println!("{} {}", block.id, block.label.as_deref().unwrap_or(""));
    Ok(())
}

<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

$result = $client->workflows()->blocks()->update(
    blockId: 'blk_extract_1',
);
print_r($result);

using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

var result = await client.Workflows.Blocks.UpdateAsync("blk_extract_1", new WorkflowBlocksUpdateOptions());
Console.WriteLine(result);

import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var result = client.workflows().blocks().update("block_abc123", "wf_abc123", null, null, null, null, null, null, null, null);
    System.out.println(result);
  }
}

curl -X 'PATCH' \
  'https://api.retab.com/v1/workflows/blocks/extract-1' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your-api-key>' \
  -d '{
    "label": "Extract Invoice Fields v2",
    "position_x": 480,
    "position_y": 160
  }'

{
  "id": "extract-1",
  "workflow_id": "wf_abc123xyz",
  "type": "extract",
  "label": "Extract Invoice Fields v2",
  "position_x": 480,
  "position_y": 160,
  "width": null,
  "height": null,
  "config": {
    "model": "gpt-5",
    "json_schema": {
      "type": "object",
      "properties": { "total": { "type": "number" } }
    }
  },
  "parent_id": null,
  "updated_at": "2026-05-01T14:30:00Z"
}

{
  "detail": "Block not found"
}