canonical: https://jentic.com/apis/inistate.com/inistate # Inistate API The Inistate API reads and writes the business records that live on the Inistate low-code platform, organized as entries inside modules inside workspaces. An agent lists the workspaces it can reach, discovers the modules available in a workspace, and then lists, creates, and updates the entries each module holds. Activities drive the workflow on an entry, and a history operation returns the actions that have been performed on it. ## For AI agents List Inistate workspaces and modules, list and filter entries, create and update entries, run activities on them, and read an entry's history through the Inistate low-code platform API. ## Scope Does not host websites, send email campaigns, or process payments. Use for reading and writing Inistate workspaces, modules, and entries only. ## Capabilities - List reachable workspaces and read a workspace's detail - Discover the modules available in a workspace - List and filter the entries held in a module - Create a new entry in a module - Update an existing entry by id - Run an activity on an entry and read its activity history ## Use cases ### Agent-Driven Record Updates An AI agent connected through Jentic lists the entries in a module, finds the one it needs with a filter, and updates it by id. Because entries, modules, and workspaces are addressed consistently, the agent reads and writes Inistate business records without a per-module integration. Example prompt: List entries in a module, filter to the matching record, and update its fields by entry id ### Workflow Activity Automation Operations teams advance records through a process by running activities. Inistate exposes an activity-form operation that returns a form definition and initial payload and an activity operation that performs the action, so an agent fetches the form, fills it, and runs the step on the right entry. Example prompt: Fetch the activity form for an entry, build the payload, and perform the activity to advance its workflow ### Module Discovery and Reporting Reporting tools map what a workspace contains before pulling data. Inistate's discovery operations list the modules in a workspace and their canvas payloads, so an agent learns the available modules and then lists each module's entries for a report. Example prompt: Discover the modules in a workspace, then list the entries in a chosen module for a summary report ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/workspace` | List reachable workspaces | | GET | `/api/workspace/{workspaceId}` | Get a workspace's detail | | POST | `/api/m/list` | List entries with filters | | POST | `/api/m` | Create a new entry | | PUT | `/api/m/{entryId}` | Update an existing entry | | POST | `/api/m/activity` | Perform an activity on an entry | | POST | `/api/m/history` | Get an entry's activity history | ## Key resources - **Workspaces** — List reachable workspaces and read a workspace's detail - **Modules** — Discover the modules and canvas payloads available in a workspace - **Entries** — List, filter, create, and update the entries a module holds - **Activities** — Fetch activity form definitions and perform activities on an entry - **History** — Read the activity history for an entry ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 41 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 87 / 100 - Developer Experience & Jentic Compatibility: 57 / 100 - AI-Readiness & Agent Experience: 19 / 100 - Agent Usability: 94 / 100 - Security: 40 / 100 - AI Discoverability: 69 / 100 - **View full report:** https://jentic.com/apis/inistate.com/inistate/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring Inistate by hand means choosing between its `Authorization` API key and its OAuth 2.0 password flow, then learning the workspace, module, and entry shape before you can read a record. Through Jentic you install once, import Inistate from the API Directory, store the credential once, and your agent calls the entry and activity operations. - **Permission scoping:** Inistate carries read operations for workspaces, modules, and entries alongside write operations that create entries, update them, and run activities. You choose the operations your agent may call, so a rule can keep it to listing and reading entries and leave entry creation, updates, or activities out unless you add them. - **Credential handling:** Your Inistate API key or OAuth token is held by your own Jentic One instance, encrypted, and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'list entries in a module' or 'run an activity on an entry', and Jentic returns the matching Inistate operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Airtable Web API** — Airtable stores records in bases and tables, versus Inistate's workspaces, modules, and entries. - **SmartSuite API** — SmartSuite manages work records and processes, an alternative platform to Inistate for structured business data. - **Activepieces API** — Activepieces runs automation flows that can read and write Inistate entries as part of a larger process. ## FAQ ### What authentication does the Inistate API use? The spec declares two options: an API key sent in the `Authorization` header in the form `fsk {your api key}`, and an OAuth 2.0 password-flow token from the `/token` endpoint. Through Jentic the credential you choose is held by your own Jentic One instance and attached to each request at execution time, so it never appears in your agent's prompt or logs. ### Can I create and update records with the Inistate API? Yes. You create an entry in a module, update an existing entry by its id, and list entries with filters. Because entries live inside modules inside workspaces, your agent reads and writes business records across the platform through one consistent shape. ### What are the rate limits for the Inistate API? The OpenAPI spec does not specify rate limits. Check the Inistate community documentation at https://community.inistate.com for current limits before running bulk entry imports or updates. ### Is there an Inistate MCP server? You do not need an MCP server to give your agent the Inistate API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the workspace, entry, and activity operations on demand without loading an extra server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the Inistate API? Yes. Write a rule that allows only the workspace and entry list operations, so the agent can read records across your modules and cannot create entries, update them, or run activities on them. You choose which operations it may call, and every call it makes is logged. ### How do I update a record through Jentic? Install the Jentic One command line with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then add the Inistate API from the Jentic directory and search by intent such as 'update an entry in a module'. Jentic returns the matching operation with its input schema so your agent builds a valid request. To run it on your own infrastructure, install Jentic One from its GitHub repo.