Contacts

Look up contacts by external reference

From a list of your references, says which ones already exist in Filmo and which do not.

Tool

filmo_contacts_lookup

Readcontacts:read

contacts:read
120/min
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_contacts_lookup",
    "arguments": {
      "references": [
        "<references>"
      ]
    }
  }
}

{
  "structuredContent": {
    "data": {
      "contacts": [
        {
          "id": "id_8f2a1c",
          "name": "Example",
          "contactNumber": "<contactNumber>"
        }
      ],
      "notFound": [
        "<notFound>"
      ]
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

notFound are the ones to create. It is the primitive of any synchronization: without it, the alternative is one call per reference and guessing from the 404. It writes NOTHING, even though it is a POST: the list of references does not fit in a query string.

Arguments

referencesstring[]Required

External references to look up. At least one, at most 200.

Limits: min 1 items, max 200 items, each min length 1

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

contactsobject[]

Contacts that matched at least one reference.

Show child attributes

contacts.idstring

Identifier of the contact in Filmo.

contacts.namestring

Contact name.

contacts.contactNumberstring

Filmo contact number.

notFoundstring[]

References that did not match any contact. These are the ones to create.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

Sample prompts

Is there already a contact with the email ana@example.com?

The same operation by REST

This tool runs POST /api/v1/contacts/lookup.

Contacts
Look up contacts by external reference
From a list of your references, says which ones already exist in Filmo and which do not.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

Sample prompts

The same operation by REST

Related pages

Look up contacts by external reference

Safe writes

Errors