Skip to content

SDK v1.5.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Feb 13:42
· 127 commits to main since this release
v1.5.1
36e7f1a

Highlights

Fixes writing to multi-select dropdown fields. --set and --append now correctly handle the array format required by the API, and --append properly merges with existing selections instead of replacing them.

Bug Fixes

  • CLI: --set and --append now work correctly for dropdown-multi fields when V1 API returns value_type="dropdown" with allows_multiple=True. Previously, resolve_dropdown_value only checked value_type (not allows_multiple) to determine the payload format, sending {"dropdownOptionId": ID} instead of [{"dropdownOptionId": ID}].
  • CLI: --append for dropdown-multi fields now merges with existing values instead of replacing them. The V2 API replaces the entire option array on POST, so --append now reads existing selections, adds the new option (deduplicating), and sends the combined array.

Quick Install

SDK only:

pip install affinity-sdk

SDK + CLI:

pipx install "affinity-sdk[cli]"

MCP Server for Claude Desktop (easiest - MCPB bundle):

  1. Install CLI: pipx install "affinity-sdk[cli]"
  2. (Optional) Pre-configure API key: xaffinity config setup-key
    • If skipped, Claude Desktop will prompt for your API key during install
  3. Install xaffinity MCP in Claude Desktop (download and double-click)

Other MCP clients (Cursor, Windsurf, VS Code, etc.) require manual configuration - see MCP docs.

Full documentation | MCP Server docs

Assets 6
Loading