Turso integration: operations for AI agents
Turso connects to Type.com as an integration. This page lists the 53 operations documented for Claude and Codex in Type.com: 27 read, 12 write, 14 destructive.
About Turso
Turso Platform API reference operations, subject to Type setup and account permissions.
Categories: Developer Tools & IT
How to connect Turso to Type.com
- Connect
- Configure provider-specific API target and authentication setup.
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
53 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
53 operations listed.
Organizations
- Read
List Databases
Returns a list of databases belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/databases - Read
Retrieve Database
Returns a database belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/databases/{databaseName} - Read
Retrieve Database Configuration
Retrieve an individual database configuration belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/databases/{databaseName}/configuration - Read
List Database Instances
Returns a list of instances of a database. Instances are the individual primary or replica databases in each region defined by the group.
GET /v1/organizations/{organizationSlug}/databases/{databaseName}/instances - Read
Retrieve Database Instance
Return the individual database instance by name.
GET /v1/organizations/{organizationSlug}/databases/{databaseName}/instances/{instanceName} - Read
Retrieve Database Usage
Fetch activity usage for a database in a given time period.
GET /v1/organizations/{organizationSlug}/databases/{databaseName}/usage - Read
Retrieve Database Stats
Fetch the top queries of a database, including the count of rows read and written.
GET /v1/organizations/{organizationSlug}/databases/{databaseName}/stats - Read
List Groups
Returns a list of groups belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/groups - Read
Retrieve Group
Returns a group belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/groups/{groupName} - Read
Retrieve Group Configuration
Retrieve an individual group configuration belonging to the organization or user.
GET /v1/organizations/{organizationSlug}/groups/{groupName}/configuration - Read
List Organizations
Returns a list of organizations the authenticated user owns or is a member of.
GET /v1/organizations - Read
Retrieve Organization
Retrieve details of a specific organization.
GET /v1/organizations/{organizationSlug} - Read
List Plans
Returns a list of available plans and their quotas.
GET /v1/organizations/{organizationSlug}/plans - Read
List Invoices
Returns a list of invoices for the organization.
GET /v1/organizations/{organizationSlug}/invoices - Read
Current Subscription
Returns the current subscription details for the organization.
GET /v1/organizations/{organizationSlug}/subscription - Read
Organization Usage
Fetch current billing cycle usage for an organization.
GET /v1/organizations/{organizationSlug}/usage - Read
List Members
Returns a list of members part of the organization.
GET /v1/organizations/{organizationSlug}/members - Read
Retrieve Member
Retrieve details of a specific member in the organization.
GET /v1/organizations/{organizationSlug}/members/{username} - Read
List Organization API Tokens
Returns the API tokens scoped to this organization (both organization-scoped and group-scoped). Unrestricted tokens are not returned here — manage those via [`GET /v1/auth/api-tokens`](/api-reference/tokens/list). Authorization is symmetric with the revoke endpoint: - **Admins and owners** see every token scoped to the organization, with the minting user attached in the `owner` field. - **Members and viewers** see only tokens they minted themselves. This mirrors the personal-access-token model used in GitHub organization settings: admins get the full attribution list; everyone else sees their own access.
GET /v1/organizations/{organizationSlug}/api-tokens - Read
List Audit Logs
Return the audit logs for the given organization, ordered by the `created_at` field in descending order.
GET /v1/organizations/{organizationSlug}/audit-logs - Read
List Invites
Returns a list of pending invites for the organization.
GET /v2/organizations/{organizationSlug}/invites - Read
List Deleted Databases
Returns databases deleted within the last five days, which can still be restored. Requires a paid plan. Available even while recovery is disabled for the organization.
GET /v3/organizations/{organizationId}/databases - Read
List Deleted Groups
Returns groups deleted within the last five days, including empty groups, which can still be restored. Requires a paid plan and an organization-level token. Available even while recovery is disabled for the organization.
GET /v3/organizations/{organizationId}/deleted-groups - Write
Create Database
Creates a new database in a group for the organization or user.
POST /v1/organizations/{organizationSlug}/databases - Write
Generate Database Auth Token
Generates an authorization token for the specified database.
POST /v1/organizations/{organizationSlug}/databases/{databaseName}/auth/tokens - Write
Create Group
Creates a new group for the organization or user.
POST /v1/organizations/{organizationSlug}/groups - Write
Unarchive Group
Unarchive a group that has been archived due to inactivity.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/unarchive - Write
Add Location to Group
Adds a location to the specified group.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/locations/{location} - Write
Update Databases in a Group
Updates all databases in the group to the latest libSQL version.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/update - Write
Create Group Auth Token
Generates an authorization token for the specified group.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/auth/tokens - Write
Add Member
Add an existing Turso user to an organization.
POST /v1/organizations/{organizationSlug}/members - Write
Invite Organization Member
Invite a user to an organization. If the user isn't already registered with Turso, they will receive a signup link. If an existing pending invite exists for the same email, it will be replaced.
POST /v2/organizations/{organizationSlug}/invites - Write
Restore Database
Restore a database deleted within the last five days, exactly as it was at the moment it was deleted. Requires a paid plan, an admin or owner of the organization, and recovery enabled for the organization.
POST /v3/organizations/{organizationId}/databases/{databaseId}/restore - Write
Restore Group
Restore a group deleted within the last five days, along with the member databases that were deleted with it. Requires a paid plan, an admin or owner of the organization, and recovery enabled for the organization. If some databases fail to restore, the group still becomes active: retry the failed database UUIDs individually with Restore Database.
POST /v3/organizations/{organizationId}/groups/{groupId}/restore - Destructive
Delete Database
Delete a database belonging to the organization or user.
DELETE /v1/organizations/{organizationSlug}/databases/{databaseName} - Destructive
Update Database Configuration
Update a database configuration belonging to the organization or user.
PATCH /v1/organizations/{organizationSlug}/databases/{databaseName}/configuration - Destructive
Invalidate All Database Auth Tokens
Invalidates all authorization tokens for the specified database.
POST /v1/organizations/{organizationSlug}/databases/{databaseName}/auth/rotate - Destructive
Delete Group
Delete a group belonging to the organization or user.
DELETE /v1/organizations/{organizationSlug}/groups/{groupName} - Destructive
Update Group Configuration
Update a group configuration belonging to the organization or user.
PATCH /v1/organizations/{organizationSlug}/groups/{groupName}/configuration - Destructive
Transfer Group
Transfer a group to another organization that you own or a member of.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/transfer - Destructive
Remove Location from Group
Removes a location from the specified group.
DELETE /v1/organizations/{organizationSlug}/groups/{groupName}/locations/{location} - Destructive
Invalidate All Group Auth Tokens
Invalidates all authorization tokens for the specified group.
POST /v1/organizations/{organizationSlug}/groups/{groupName}/auth/rotate - Destructive
Update Organization
Update an organization you own or are a member of.
PATCH /v1/organizations/{organizationSlug} - Destructive
Update Member Role
Update the role of an organization member. Only organization admins or owners can perform this action.
PATCH /v1/organizations/{organizationSlug}/members/{username} - Destructive
Remove Member
Remove a user from the organization by username.
DELETE /v1/organizations/{organizationSlug}/members/{username} - Destructive
Revoke Organization API Token
Revokes a token scoped to this organization. The path takes a token **ID**, not a name, because names are unique per user but not across users — an admin revoking a member's token can't disambiguate by name alone. Authorization is symmetric with the list endpoint: - **Admins and owners** can revoke any token scoped to the organization (org-scoped or group-scoped, regardless of who minted it). - **Members and viewers** can revoke only tokens they minted themselves. A token scoped to a different organization returns `404`, not `403`, so the endpoint does not leak the existence of cross-org token IDs. Unrestricted tokens are also unreachable here and must be revoked via [`DELETE /v1/auth/api-tokens/{tokenName}`](/api-reference/tokens/revoke).
DELETE /v1/organizations/{organizationSlug}/api-tokens/{tokenId} - Destructive
Delete Invite
Delete a pending invite for the organization by email.
DELETE /v2/organizations/{organizationSlug}/invites/{email}
Locations
- Read
List Locations
Returns a list of locations where you can create or replicate databases.
GET /v1/locations
Auth
- Read
Validate API Token
Validates an API token belonging to a user.
GET /v1/auth/validate - Read
List API Tokens
Returns a list of API tokens belonging to a user.
GET /v1/auth/api-tokens - Write
Create API Token
Returns a new API token belonging to a user. The token can be minted at three levels of restriction, in increasing order of narrowness: - **Organization-scoped** — pass `organization`, and optionally `scopes`. The token can only act on resources inside that organization. With `scopes`, it can do only the listed operations, in every group of the organization. - **Group-scoped** — pass `organization`, `group`, and `scopes`. The token is pinned to a single group inside the organization and only the operations listed in `scopes` are allowed. The caller must be an admin or owner of the organization. - **Unrestricted** *(deprecated)* — no request body. The token can act on every organization the caller belongs to. **Unrestricted tokens are deprecated and will be removed in a future release.** Always pass `organization` for new tokens and rotate existing unrestricted tokens to scoped tokens. Group-scoped tokens are designed for automations that should be able to provision and manage databases inside a single group without being able to touch the rest of the organization.
POST /v1/auth/api-tokens/{tokenName} - Destructive
Revoke API Token
Revokes the provided API token belonging to a user.
DELETE /v1/auth/api-tokens/{tokenName}
User
- Read
Get Current User
Returns information about the currently authenticated user.
GET /v1/user
No operations match.
See How connections work for access and permissions, or browse all integrations.