Skip to content
Changelog

Report a bug

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

See How connections work for access and permissions, or browse all integrations.