# item API

## Docs

- [Batch create or update objects](https://docs.item.app/api-reference/batch/batch-create-or-update-objects.md): Creates or updates up to 100 objects in a single request. Ideal for scheduled syncs (e.g., pushing data every 5 minutes).
- [Create an object](https://docs.item.app/api-reference/objects/create-an-object.md): Creates a new object of the specified type.
- [Delete an object](https://docs.item.app/api-reference/objects/delete-an-object.md): Soft-deletes an object by ID. The record is marked as deleted but not permanently removed. All relationships involving this object are also soft-deleted.
- [List objects or fetch by ID](https://docs.item.app/api-reference/objects/list-objects-or-fetch-by-id.md): **List mode** (no `id` or `email` param): Returns a paginated list of objects with optional search, filtering, and sorting.
- [Update a single custom field](https://docs.item.app/api-reference/objects/update-a-single-custom-field.md): Updates one custom field on an existing object. This is the legacy endpoint — for updating multiple fields at once, use `PATCH` instead.
- [Update multiple fields](https://docs.item.app/api-reference/objects/update-multiple-fields.md): Updates one or more fields on an existing object in a single request.
- [Get object schema](https://docs.item.app/api-reference/schema/get-object-schema.md): Returns all object types available to the organization along with their field definitions. Use this to discover what objects exist, what fields they have, and what select options are available.
- [List organization users](https://docs.item.app/api-reference/users/list-organization-users.md): Returns all users in the organization with their IDs and access levels. Useful for mapping `owned_by_user_id` values or assigning records to users.
- [Execute a view](https://docs.item.app/api-reference/views/execute-a-view.md): Executes a shared view and returns paginated results. The view's filters, sorting, and column configuration are applied automatically.
- [List available views](https://docs.item.app/api-reference/views/list-available-views.md): Returns all shared views configured for the given object type. Views are pre-configured filters, sorting, and column layouts created in the item UI.
- [Trigger a skill via webhook](https://docs.item.app/api-reference/webhooks/trigger-a-skill-via-webhook.md): Sends a webhook payload to trigger a skill (AI agent) run. The skill must have a webhook trigger configured and be in "live" status.
- [item API](https://docs.item.app/index.md): Push and pull customer data with the item API
- [Official item MCP](https://docs.item.app/mcp-docs.md): Connect item to MCP clients including Cursor, ChatGPT, Claude, Claude Code, and Codex

## OpenAPI Specs

- [openapi](https://docs.item.app/openapi.yaml)