# Datagrid AI

## Docs

- [Create agent](https://developers.datagrid.com/api-reference/agents/create-agent.md): Create a new agent
- [Delete agent](https://developers.datagrid.com/api-reference/agents/delete-agent.md): Delete an agent
- [List agents](https://developers.datagrid.com/api-reference/agents/list-agents.md): List all agents for the authenticated organization
- [Retrieve agent](https://developers.datagrid.com/api-reference/agents/retrieve-agent.md): Get details of a specific agent
- [Update agent](https://developers.datagrid.com/api-reference/agents/update-agent.md): Update an agent configuration
- [Create connection provider](https://developers.datagrid.com/api-reference/connection-providers/create-connection-provider.md): Create a new connection provider that specifies custom OAuth credentials for a connector. Verify that your OAuth app meets the connector's OAuth app settings requirements.
- [Delete connection provider](https://developers.datagrid.com/api-reference/connection-providers/delete-connection-provider.md): Delete a connection provider.
- [List connection providers](https://developers.datagrid.com/api-reference/connection-providers/list-connection-providers.md): Returns the list of connection providers.
- [Retrieve connection provider](https://developers.datagrid.com/api-reference/connection-providers/retrieve-connection-provider.md): Retrieve a specific connection provider by ID.
- [Update connection provider](https://developers.datagrid.com/api-reference/connection-providers/update-connection-provider.md): Update a connection provider.
- [Create connection](https://developers.datagrid.com/api-reference/connections/create-connection.md): Creates a new connection to authenticate with a third-party service (like Google Drive, Hubspot, Dropbox, etc.) and returns a redirect URL for the connection authentication flow.
- [Delete connection](https://developers.datagrid.com/api-reference/connections/delete-connection.md): Delete an authenticated connection to a third-party service.
- [List connections](https://developers.datagrid.com/api-reference/connections/list-connections.md): Returns the list of authenticated connections to third-party services.
- [Retrieve connection](https://developers.datagrid.com/api-reference/connections/retrieve-connection.md): Retrieves details about an authenticated connection by id.
- [Update connection](https://developers.datagrid.com/api-reference/connections/update-connection.md): Update a connection's attributes.
- [List connectors](https://developers.datagrid.com/api-reference/connectors/list-connectors.md): Returns the list of available connectors that can be used to connect to third-party services.
- [Create conversation](https://developers.datagrid.com/api-reference/conversations/create-conversation.md): Creates a new conversation.
- [Delete conversation](https://developers.datagrid.com/api-reference/conversations/delete-conversation.md): Delete conversation.
- [List conversations](https://developers.datagrid.com/api-reference/conversations/list-conversations.md): Returns the list of conversations.
- [List messages](https://developers.datagrid.com/api-reference/conversations/list-messages.md): Returns the list of messages in a conversation.
- [Retrieve conversation](https://developers.datagrid.com/api-reference/conversations/retrieve-conversation.md): Retrieves a conversation by id.
- [Retrieve message](https://developers.datagrid.com/api-reference/conversations/retrieve-message.md): Retrieves a message by id.
- [Update conversation](https://developers.datagrid.com/api-reference/conversations/update-conversation.md): Update a conversation's properties, such as assigned agents or name.
- [Converse](https://developers.datagrid.com/api-reference/converse/converse.md): Converse with an AI Agent
- [File Inputs](https://developers.datagrid.com/api-reference/converse/file-inputs.md): Learn how to use and files as inputs to the converse API.
- [Knowledge and corpus](https://developers.datagrid.com/api-reference/converse/knowledge-and-corpus.md): Control which knowledge your agent uses when answering questions.
- [MCP Servers (Beta)](https://developers.datagrid.com/api-reference/converse/mcp-servers.md): Connect external tools to your agent using the Model Context Protocol.
- [Converse Modes](https://developers.datagrid.com/api-reference/converse/modes.md): Map in-app Ask / Extended / Execute to config.agent_model and chat_mode on Converse.
- [Streaming](https://developers.datagrid.com/api-reference/converse/streaming.md): Stream a conversation with an AI Agent
- [Structured Outputs](https://developers.datagrid.com/api-reference/converse/structured-outputs.md): Ensure responses adhere to a JSON schema.
- [Get credits](https://developers.datagrid.com/api-reference/credits/get-credits.md): Summarise the credits in your account for the current billing period.
- [Create data view](https://developers.datagrid.com/api-reference/data-views/create-data-view.md): Creates a new data view for a knowledge source, providing controlled access through a service account. This endpoint requires credits and meters setup work based on the number of warehouse operations performed for the request.
- [Create service account](https://developers.datagrid.com/api-reference/data-views/create-service-account.md): Creates a service account for accessing data views. Only one service account per teamspace is allowed.
- [Delete data view](https://developers.datagrid.com/api-reference/data-views/delete-data-view.md): Removes a data view.
- [Delete service account](https://developers.datagrid.com/api-reference/data-views/delete-service-account.md): Removes a service account and all associated data views.
- [Get service account credentials](https://developers.datagrid.com/api-reference/data-views/get-service-account-credentials.md): Retrieves the credentials (private key) for a service account.
- [List data views](https://developers.datagrid.com/api-reference/data-views/list-data-views.md): Returns the list of data views for a service account.
- [List service accounts](https://developers.datagrid.com/api-reference/data-views/list-service-accounts.md): Returns the list of service accounts for your teamspace. Only one service account per teamspace is allowed at this time.
- [Create files](https://developers.datagrid.com/api-reference/files/create-files.md): Create files which can be passed as input to agents. This endpoint consumes a flat credit charge per upload. The response includes a `credits` field with the amount consumed, or `null` if the billing write fails — the upload still succeeds in that case.
- [Delete file](https://developers.datagrid.com/api-reference/files/delete-file.md): Delete file.
- [List files](https://developers.datagrid.com/api-reference/files/list-files.md): Returns the list of files.
- [Retrieve file](https://developers.datagrid.com/api-reference/files/retrieve-file.md): Retrieves a file by id.
- [Retrieve file content](https://developers.datagrid.com/api-reference/files/retrieve-file-content.md): Returns the content of a file.
- [Update file](https://developers.datagrid.com/api-reference/files/update-file.md): Update file metadata.
- [Retrieve current identity](https://developers.datagrid.com/api-reference/identity/retrieve-current-identity.md): Returns the identity of the authenticated caller — the user ID, current teamspace, and all teamspace memberships that the API key or JWT resolves to.
- [Create knowledge](https://developers.datagrid.com/api-reference/knowledge/create-knowledge.md): Create knowledge which will be learned and leveraged by agents. Processing continues asynchronously after the request returns. If the background processing run later fails, subsequent retrievals surface that terminal state through `status` and `last_error`.
- [Create knowledge from connection](https://developers.datagrid.com/api-reference/knowledge/create-knowledge-from-connection.md): Initiates knowledge creation from a connection by returning a redirect URL. The organization must have enough credits to start this flow. The downstream ingestion and indexing that follow still run asynchronously, and the actual credit consumption remains variable based on the volume of data process…
- [Delete knowledge](https://developers.datagrid.com/api-reference/knowledge/delete-knowledge.md): Delete knowledge.
- [List knowledge](https://developers.datagrid.com/api-reference/knowledge/list-knowledge.md): Returns a list of knowledge.
- [Reindex knowledge](https://developers.datagrid.com/api-reference/knowledge/reindex-knowledge.md): Manually trigger a full re-indexing of the knowledge. The reindex runs **asynchronously**: the API returns as soon as the job is enqueued. Re-indexing is not performed immediately. This endpoint consumes credits — the actual credit cost is variable, based on the volume of data being re-indexed, and…
- [Retrieve knowledge](https://developers.datagrid.com/api-reference/knowledge/retrieve-knowledge.md): Retrieves knowledge by id.
- [Update knowledge](https://developers.datagrid.com/api-reference/knowledge/update-knowledge.md): Update a knowledge's attributes. Each request can include either `files` or `sync`, but not both. When `files` are provided, all existing data is replaced and a re-processing pipeline runs asynchronously — this consumes credits based on the volume of data processed. Metadata-only and sync-only updat…
- [Create MCP server](https://developers.datagrid.com/api-reference/mcp-servers/create-mcp-server.md): Register a new MCP server in the current teamspace. Each teamspace can have at most 30 registered MCP servers.
- [Delete MCP server](https://developers.datagrid.com/api-reference/mcp-servers/delete-mcp-server.md): Delete a registered MCP server.
- [List MCP servers](https://developers.datagrid.com/api-reference/mcp-servers/list-mcp-servers.md): List registered MCP servers for the current teamspace.
- [Overview](https://developers.datagrid.com/api-reference/mcp-servers/overview.md): Register and manage MCP servers at teamspace scope for use in converse.
- [Retrieve MCP server](https://developers.datagrid.com/api-reference/mcp-servers/retrieve-mcp-server.md): Retrieve a registered MCP server.
- [Update MCP server](https://developers.datagrid.com/api-reference/mcp-servers/update-mcp-server.md): Update a registered MCP server.
- [Create User Memory](https://developers.datagrid.com/api-reference/memory/create-user-memory.md): Create a user memory. This endpoint requires credits and meters the actual embedding work performed for the request. The response includes `credits.consumed` with the billed amount, or `null` if the billing write fails after the memory is successfully created.
- [Delete User Memory](https://developers.datagrid.com/api-reference/memory/delete-user-memory.md): Delete a user memory
- [List User Memory](https://developers.datagrid.com/api-reference/memory/list-user-memory.md): List the memories for a given user and agent that the user has access to
- [Create page](https://developers.datagrid.com/api-reference/pages/create-page.md): Create a new page
- [Delete page](https://developers.datagrid.com/api-reference/pages/delete-page.md): Delete a page. The page must have no children or all its children must have been deleted before invoking this API.
- [List pages](https://developers.datagrid.com/api-reference/pages/list-pages.md): List all pages for the authenticated organization
- [Retrieve page](https://developers.datagrid.com/api-reference/pages/retrieve-page.md): Get details of a specific page
- [Update page](https://developers.datagrid.com/api-reference/pages/update-page.md): Update a page's attributes
- [Rate Limits](https://developers.datagrid.com/api-reference/rate-limits.md): Understand Datagrid API rate limits, response headers, and best practices for handling 429 responses
- [AI Search](https://developers.datagrid.com/api-reference/search/ai-search.md): AI-powered search that retrieves relevant knowledge from your teamspace, builds a merged context, and generates a natural language answer with numbered source citations. The response includes the generated answer, the sources cited (with links and metadata), and the full search tree results for refe…
- [Search](https://developers.datagrid.com/api-reference/search/search.md): [DEPRECATED] Search across knowledge. Use /search/ai for AI-powered generative search or /search/tree for merged context tree results.
- [Search Tree](https://developers.datagrid.com/api-reference/search/search-tree.md): Search across your teamspace's indexed knowledge and return results as a hierarchical context tree. Results are grouped by source (datasets, files, pages) with navigation items for quick access. Supports pagination via cursor-based `next` parameter. This endpoint is the foundation for the AI Search…
- [Create secret](https://developers.datagrid.com/api-reference/secrets/create-secret.md): Create a new secret that can be referenced in converse API calls.
- [Delete secret](https://developers.datagrid.com/api-reference/secrets/delete-secret.md): Delete a secret.
- [List secrets](https://developers.datagrid.com/api-reference/secrets/list-secrets.md): Returns the list of user-created secrets.
- [Retrieve secret](https://developers.datagrid.com/api-reference/secrets/retrieve-secret.md): Retrieve a specific secret by ID.
- [List records](https://developers.datagrid.com/api-reference/tables/list-records.md): Returns a list of records for a table.
- [List tables](https://developers.datagrid.com/api-reference/tables/list-tables.md): Returns a list of tables.
- [Replicating Tables](https://developers.datagrid.com/api-reference/tables/replicating-tables.md): Incrementally replicate table records to your destination system
- [Retrieve table](https://developers.datagrid.com/api-reference/tables/retrieve-table.md): Retrieves a table by id.
- [Delete teamspace invite](https://developers.datagrid.com/api-reference/teamspace-invites/delete-teamspace-invite.md): Delete a pending invite for a user in a teamspace.
- [Invite user to a teamspace](https://developers.datagrid.com/api-reference/teamspace-invites/invite-user-to-a-teamspace.md): Invite a user to join the teamspace. This will send an invitation email. If the user already exists, the invite will be automatically accepted.
- [List teamspace invites](https://developers.datagrid.com/api-reference/teamspace-invites/list-teamspace-invites.md): List all pending invites for a teamspace.
- [Retrieve teamspace invite](https://developers.datagrid.com/api-reference/teamspace-invites/retrieve-teamspace-invite.md): Get a pending invite for in a teamspace.
- [Delete teamspace user](https://developers.datagrid.com/api-reference/teamspace-users/delete-teamspace-user.md): Revoke a user's permissions from the teamspace.
- [List teamspace users](https://developers.datagrid.com/api-reference/teamspace-users/list-teamspace-users.md): Retrieve a list of users in the specified teamspace.
- [Retrieve teamspace user](https://developers.datagrid.com/api-reference/teamspace-users/retrieve-teamspace-user.md): Retrieve details of a specific user in the teamspace.
- [Update teamspace user](https://developers.datagrid.com/api-reference/teamspace-users/update-teamspace-user.md): Update user permissions in the teamspace.
- [Create teamspace](https://developers.datagrid.com/api-reference/teamspaces/create-teamspace.md): Create a new teamspace within your organization.
- [List teamspaces](https://developers.datagrid.com/api-reference/teamspaces/list-teamspaces.md): Returns the list of teamspaces within your organization.
- [Retrieve teamspace](https://developers.datagrid.com/api-reference/teamspaces/retrieve-teamspace.md): Retrieve a specific teamspace by ID.
- [Scope Requests to a Teamspace](https://developers.datagrid.com/api-reference/teamspaces/scope-to-teamspace.md): Learn how to scope API requests to a specific teamspace
- [Update teamspace](https://developers.datagrid.com/api-reference/teamspaces/update-teamspace.md): Update the name and/or access settings of a teamspace.
- [List tools](https://developers.datagrid.com/api-reference/tools/list-tools.md): Returns the list of available tools that can be used by agents.
- [Retrieve tool](https://developers.datagrid.com/api-reference/tools/retrieve-tool.md): Retrieves a specific tool by its identifier.
- [List users](https://developers.datagrid.com/api-reference/users/list-users.md): Retrieve a list of users in the specified organization.
- [Retrieve user](https://developers.datagrid.com/api-reference/users/retrieve-user.md): Retrieve details of a specific user in the organization.
- [Update user](https://developers.datagrid.com/api-reference/users/update-user.md): Update user permissions in the organization.
- [iOS / Swift Integration](https://developers.datagrid.com/api-reference/voice/ios-integration.md): Build a real-time voice assistant in an iOS app using the Datagrid Voice WebSocket API
- [Start voice session](https://developers.datagrid.com/api-reference/voice/start-voice-session.md): Prepare a real-time voice conversation with an AI Agent.
- [Voice Conversations](https://developers.datagrid.com/api-reference/voice/voice.md): Real-time voice conversations with AI Agents using WebSockets
- [Create webhook](https://developers.datagrid.com/api-reference/webhooks/create-webhook.md): Create a webhook subscription for your teamspace.
- [Delete webhook](https://developers.datagrid.com/api-reference/webhooks/delete-webhook.md): Delete a webhook subscription.
- [List active webhooks for event](https://developers.datagrid.com/api-reference/webhooks/list-active-webhooks-for-event.md): Returns enabled webhook subscriptions for a specific event type.
- [List webhooks](https://developers.datagrid.com/api-reference/webhooks/list-webhooks.md): Returns a cursor-paginated list of webhook subscriptions.
- [Retrieve webhook](https://developers.datagrid.com/api-reference/webhooks/retrieve-webhook.md): Retrieve a specific webhook subscription by ID.
- [Update webhook](https://developers.datagrid.com/api-reference/webhooks/update-webhook.md): Update webhook configuration. You can modify the URL, subscribed events, and enabled status.
- [All Connectors](https://developers.datagrid.com/connectors/all-connectors.md): Complete list of all available connectors in Datagrid AI
- [Connecting Agents to Apps](https://developers.datagrid.com/introduction/connections.md): Learn how to embed Datagrid's connection creation flow in your application
- [Creating Data Views](https://developers.datagrid.com/introduction/data-views.md): Learn how to share knowledge with Data Views and Service Accounts
- [Quickstart](https://developers.datagrid.com/introduction/quickstart.md): Start using Datagrid in under 5 minutes
- [Knowledge upload limits](https://developers.datagrid.com/knowledge/upload-limits.md): File size limits for the Knowledge API, how uploads are handled, and strategies for working with large documents.

## OpenAPI Specs

- [openapi.documented](https://app.stainless.com/api/spec/documented/datagrid/openapi.documented.yml)
- [openapi](https://developers.datagrid.com/api-reference/openapi.json)

## Optional

- [Get your API Key](https://app.datagrid.com/chats?at=chats&st=api_keys&redirect_url=chats?at=chats%26st=api_keys)
- [Join us on Slack](https://join.slack.com/t/datagrid-users/shared_invite/zt-2tl2omd78-qO8zHN5_sK39_lRsyZA4Dg)