Skip to content
TakoAPI
Back to skills

odoo-json2-operator

by sncic

Search & Research
—Not yet rated
Your rating

Brief

Execute Odoo operations through JSON-2 API endpoints with bearer API keys.

Description

What This Skill Does

Executes Odoo model operations through the JSON-2 HTTP API using bearer authentication. Supports search, read, create, write, unlink, and custom model methods. Validates model names and method signatures via the api_doc module before each call.

Discovery-first validation against /doc-bearer endpoints catches invalid model or method names before execution, avoiding silent failures common with direct API calls.

When to Use It

  • Search customer records by name or email in Odoo
  • Create sales orders without logging into the Odoo UI
  • Update product prices or inventory fields across records
  • Run custom model methods for specific business workflows
  • Pull period-based data from Odoo for management reporting

Example Workflow

INPUT

User asks: Find all customers whose name contains 'Acme' and show their emails

AGENT
  1. 1

    Load saved connection profile or collect base_url, database, and api_key

  2. 2

    Call /doc-bearer/index.json to confirm res.partner model is available

  3. 3

    Call /doc-bearer/res.partner.json to validate search_read method and parameters

  4. 4

    Build payload with domain [["name", "ilike", "Acme"]] and fields ["name", "email"]

  5. 5

    POST to /json/2/res.partner/search_read and return matching records

OUTPUT

List of res.partner records with name and email fields matching 'Acme'

Requirements

  • Odoo instance URL
  • Odoo database name
  • Odoo bearer API key

Installation

clawhub install sncic/odoo-json2-operator

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links