Effective

Create, update or delete Effective data. Supply the endpoint URI, its documented HTTP method and inputs. Use discover to find an endpoint or inspect for its contract. Execute only when the requested change and its required inputs are known. API reference: https://docs.effectiveai.app/llms.txt.

mutate

Identify the connected Effective user and organization, and whether this connection can change data (canMutate). Use when you need to confirm which account and organization your requests use, or before planning changes.

whoami

Find the Effective endpoint for a task. Describe what you want in query and optionally why in intent. Returns up to three suggested list, read or mutate calls with arguments. Use inspect for endpoint parameters and contract details when needed. Review suggestions and resolve missing inputs or unsupported constraints before executing a call.

discover

Inspect an Effective endpoint when you need details about its inputs or results. Supply its effective://api URI or URI template to see each supported operation. Optionally supply method to inspect one operation, and include to return only the parts you need: description, inputs (toolInputs gives path, parameters and fields in the exact shape list, read and mutate accept), response (success schema), errors, or access (authorization requirements). Omit include for everything. Shared error bodies appear once as errorSchema. API reference: https://docs.effectiveai.app/llms.txt.

inspect

Browse an Effective collection using filters, sorting and pagination. Supply a collection URI and its supported parameters, and choose which item fields to return with fields. Follow an item’s $uri with read for its full content. To get the next page, repeat the same call with cursor set to the returned nextCursor; null means there are no more pages. Returns up to 20 items by default where pagination is supported; availableFields appears on the first page. API reference: https://docs.effectiveai.app/llms.txt.

list

Return the complete JSON for one Effective item, or one page of full rows from a collection, each row with its $uri. Supply an effective://api URI and put query options in parameters, never in the URI. To scan a collection by chosen fields, use list. Returned suggestions and actions name ready next reads and operations. A file download link names its host in networkRequirement; if fetching it is refused, the user needs to allow that host, and .../contents or .../text work meanwhile. API reference: https://docs.effectiveai.app/llms.txt.

read

Tell Effective that you could not complete the user’s task with these tools. Call it once per task, after reasonable attempts have failed, or as soon as the API clearly lacks an endpoint, field or permission you need. Do not call it for errors you recovered from. Describe the goal and blocker in your own words without copying the user’s documents or record contents, and cite the meta.requestId values of the results that failed or did not help. Afterwards, share the returned caseId with the user so they can follow up with Effective support ([email protected]) if they wish.

feedback