Sanity
developer tools 16 tools availableSanity is a headless CMS platform that provides structured content storage and APIs for modern applications
About this integration
Connect Sanity to Definable to triage issues, review pull requests, monitor builds. Personas call Sanity's 16 tools directly from chat or scheduled flows. Wire it into a triage, review, or release-management persona — every action runs scoped, reviewable, and logged.
Connect Sanity to Definable and it becomes a set of typed tools your agents plan with — triggered by events, run on schedules, or invoked mid-conversation. Every write is checked by the verifier before it lands.
Sanity · in workflows
What teams actually run.
Three patterns teams run with Sanity on day one. Each one is a plain-English prompt — no canvas, no glue code — and you can remix them into anything.
Auto-review PRs
Failing-build alerts
16 tools available
The Sanity toolbox.
Every Sanity capability your agents can call, each with a typed schema the planner reads. The router picks the right tool per step; the verifier checks the result.
Add Default Role to Users Apply organization default role to all users. Use when you need to assign the organization's default role to all existing users in the organization. Requires the resource ID of the organization.
Create Attribute Definition Tool to create a new user attribute definition in Sanity. Use when you need to define a custom attribute (like 'customer-tier' or 'subscription-level') that can be attached to resources. The key must be unique within the resource. The attribute can have a type of 'string', 'number', or 'boolean' and can optionally be a list of values or read-only.
Create Prompt Post Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation context.
Delete User Attribute Definition Delete a user attribute definition. Use when you need to remove a custom attribute definition from an organization or project in Sanity. The attribute definition controls how user attributes are structured and validated for a given resource. Deleting a definition does not delete existing user attribute values, but users will no longer be able to set values for that attribute.
Delete User Attributes Delete custom attributes from a Sanity user within an organization. Use this tool when you need to remove specific custom attributes from a user account. The action deletes the attributes specified in the request and returns the updated attribute list for the user. Example use case: Removing outdated metadata like 'location' or 'year_started' from a user profile.
Get Invite By Token Retrieve an invite by its public token. Use this action when you need to fetch details about an invite using the invite token that was shared with the invitee. Returns invite information including status, role, and inviter details.
Get Organization Role Retrieve a specific organization role by its ID. Use this action when you need to fetch details about an organization role including its permissions, title, description, and whether it applies to users or robots. The role must exist for the specified organization.
Get Permission Get a permission for a specific resource. Use when you need to retrieve details about a particular permission including its actions, parameters, and scope. The action retrieves permission information based on the resource type, resource ID, and permission name provided in the path parameters.
Get Robots Tool to get robots with access to a resource. Use when you need to retrieve a list of robots (service accounts) that have been granted access to a specific resource along with their assigned roles. This action supports pagination through the next_cursor parameter.
Get Role Retrieve a specific role for a given resource type and resource ID. Use this action when you need to fetch details about a role including its permissions, title, description, and whether it applies to users or robots. The role must exist for the specified resource.
List Resource Users List all users of a resource and their assigned roles. Use when you need to retrieve user information and role assignments for a specific project or organization. Supports pagination via cursor.
List Organization Roles List all roles available for an organization. Use this action to retrieve all available roles that can be assigned to users within a specific Sanity organization. The organization_id is required to identify which organization's roles to list.
List User Attributes Tool to retrieve user attributes from a Sanity organization. Use when you need to get the attributes (such as roles, permissions, or custom properties) associated with a specific user in a Sanity organization. Supports pagination via the cursor parameter.
Query All Screening Execute a GROQ query to fetch all screening documents from Sanity. Uses the Sanity HTTP query API endpoint. Default query retrieves all documents of type 'screening'. Supports optional query parameters for dynamic queries.
Update Organization ACL Tool to assign a role to a member in a Sanity organization. Use when adding or modifying user roles within an organization.
Update User Attributes Values Update user attribute values for a resource. Use this action to set or update custom attributes for a user within an organization or project. When setting a value for an attribute key that also exists in SAML, the Sanity value will take precedence and shadow the SAML value.
See it run
One prompt, start to finish.
A real prompt, the Sanity tools it calls, and what comes back. This is the whole interface — describe the outcome, agents handle the rest.
Run a real Sanity task end-to-end — plan it, execute across the API, and hand back a verified result.
sanity.add_default_role_to_users Apply organization default role to all users. Use when you need to assign the organization sanity.create_attribute_definition Tool to create a new user attribute definition in Sanity. Use when you need to define a cu sanity.create_prompt_post Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No · verified Done. Sanity responded across 3 calls, the verifier signed off, and the result is logged with every payload.
FAQ · Sanity
Questions, answered.
What teams ask before connecting Sanity.
01 What can I automate with Sanity on Definable?
Anything Sanity exposes through its API. Common developer tools workflows on Definable include triage issues, review pull requests, monitor builds. Personas can call any of the 16 Sanity tools directly, then chain the result into another integration without you writing code.
02 How does Sanity authentication work?
Sanity uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
03 Is the Sanity integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 16 Sanity tools. You only need a separate Sanity subscription if Sanity itself charges per seat or per API call.
04 Is using Sanity through Definable secure?
Every call from a persona to Sanity is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
05 How do I get started with Sanity on Definable?
Sign up for Definable, open the integrations page, find Sanity, and connect via OAuth or API key. You can immediately attach Sanity to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
06 What Sanity actions does Definable expose?
Definable exposes all 16 Sanity actions as callable tools — including `Add Default Role to Users`, `Create Attribute Definition`, `Create Prompt Post`, plus 13 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Put Sanity to work tonight.
Connect in two clicks, describe an outcome, and your first workflow is live in minutes. Free plan included — no card required.