# Activepieces Management Octri Preview

> Activepieces Management Octri Preview API documentation

## 
- [Start here](https://octri-at67uffqbqdc.octri.dev/api-reference/start-here): Start here

## V1
- [GET /v1/agents/conversations](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-agents-conversations): List conversations
- [POST /v1/agents/conversations](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-agents-conversations): Create a conversation
- [GET /v1/agents/conversations/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-agents-conversations-id): Get a conversation
- [POST /v1/agents/conversations/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-agents-conversations-id): Update a conversation
- [DELETE /v1/agents/conversations/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-agents-conversations-id): Delete a conversation
- [GET /v1/agents/conversations/{id}/messages](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-agents-conversations-id-messages): List conversation messages
- [POST /v1/agents/conversations/{id}/messages](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-agents-conversations-id-messages): Submit a message to a conversation
- [POST /v1/agents/tool-approvals/{gateId}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-agents-tool-approvals-gateid): Submit a tool approval decision
- [GET /v1/app-connections](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-app-connections): List app connections
- [POST /v1/app-connections](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-app-connections): Create or update an app connection
- [GET /v1/app-connections/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-app-connections-id): Get an app connection
- [POST /v1/app-connections/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-app-connections-id): Update an app connection
- [DELETE /v1/app-connections/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-app-connections-id): Delete an app connection
- [POST /v1/app-connections/oauth2/authorization-url](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-app-connections-oauth2-authorization-url): Get an OAuth 2.0 authorization URL
- [GET /v1/app-connections/owners](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-app-connections-owners): List app connection owners
- [POST /v1/app-connections/replace](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-app-connections-replace): Replace an app connection
- [POST /v1/embed-subdomain/allowed-embed-origins](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-embed-subdomain-allowed-embed-origins): Add allowed iframe embed origins
- [GET /v1/event-destinations](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-event-destinations): List event destinations
- [GET /v1/flow-runs](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flow-runs): List flow runs
- [GET /v1/flow-runs/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flow-runs-id): Get a flow run
- [POST /v1/flow-runs/cancel](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-flow-runs-cancel): Cancel matching flow runs
- [GET /v1/flow-runs/count-by-status](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flow-runs-count-by-status): Count flow runs by status
- [GET /v1/flows](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flows): List flows
- [POST /v1/flows](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-flows): Create a flow
- [GET /v1/flows/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flows-id): Get a flow by ID
- [POST /v1/flows/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-flows-id): Apply an operation to a flow
- [DELETE /v1/flows/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-flows-id): Delete a flow
- [GET /v1/flows/{id}/template](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-flows-id-template): Export a flow as a template
- [GET /v1/folders](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-folders): List project folders
- [POST /v1/folders](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-folders): Create a folder
- [GET /v1/folders/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-folders-id): Get a folder
- [POST /v1/folders/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-folders-id): Update a folder
- [DELETE /v1/folders/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-folders-id): Delete a folder
- [POST /v1/git-repos](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-git-repos): Create or update project Git repository information
- [GET /v1/global-connections](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-global-connections): List global connections
- [POST /v1/global-connections](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-global-connections): Create a global connection
- [POST /v1/global-connections/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-global-connections-id): Update a global connection
- [DELETE /v1/global-connections/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-global-connections-id): Delete a global connection
- [GET /v1/knowledge-base/files](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-knowledge-base-files): List knowledge base files for a project
- [POST /v1/knowledge-base/files](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-knowledge-base-files): Register a knowledge base file
- [DELETE /v1/knowledge-base/files/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-knowledge-base-files-id): Delete a knowledge base file
- [GET /v1/knowledge-base/files/{id}/chunks](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-knowledge-base-files-id-chunks): List chunks for a knowledge base file
- [GET /v1/knowledge-base/files/{id}/chunks/count](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-knowledge-base-files-id-chunks-count): Get the chunk count for a knowledge base file
- [POST /v1/knowledge-base/files/{id}/extract-chunks](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-knowledge-base-files-id-extract-chunks): Extract chunks from a knowledge base file
- [POST /v1/knowledge-base/files/{id}/store-chunks](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-knowledge-base-files-id-store-chunks): Store or update knowledge base file chunks
- [POST /v1/knowledge-base/files/search](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-knowledge-base-files-search): Search knowledge base files by vector similarity
- [POST /v1/knowledge-base/files/upload](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-knowledge-base-files-upload): Upload a knowledge base file
- [POST /v1/mcp-oauth/approve](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-mcp-oauth-approve): Approve an MCP OAuth authorization request
- [GET /v1/mcp-server](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-mcp-server): Get the platform MCP server configuration
- [POST /v1/mcp-server](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-mcp-server): Update the platform MCP server configuration
- [POST /v1/mcp-server/rotate](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-mcp-server-rotate): Rotate the platform MCP server token
- [POST /v1/pieces](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-pieces): Add a piece to a platform
- [GET /v1/platforms/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-platforms-id): Get a platform
- [GET /v1/project-members](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-project-members): List project members
- [DELETE /v1/project-members/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-project-members-id): Delete a project member
- [POST /v1/project-releases](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-project-releases): Create a project release
- [GET /v1/project-roles/{id}/project-members](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-project-roles-id-project-members): List members assigned to a project role
- [GET /v1/projects](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-projects): List projects
- [POST /v1/projects](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-projects): Create a project
- [POST /v1/projects/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-projects-id): Update a project
- [DELETE /v1/projects/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-projects-id): Delete a project
- [POST /v1/projects/{projectId}/agent-tools/mcp/validate](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-projects-projectid-agent-tools-mcp-validate): Validate an external MCP server agent tool
- [GET /v1/projects/{projectId}/mcp-server](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-projects-projectid-mcp-server): Get a project's MCP server configuration
- [POST /v1/projects/{projectId}/mcp-server](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-projects-projectid-mcp-server): Update a project's MCP server configuration
- [POST /v1/projects/{projectId}/mcp-server/rotate](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-projects-projectid-mcp-server-rotate): Rotate a project's MCP server token
- [GET /v1/records](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-records): List records from a table
- [DELETE /v1/records](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-records): Delete records from a table
- [POST /v1/records/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-records-id): Update a record
- [GET /v1/sample-data](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-sample-data): Get sample data for a flow step
- [POST /v1/sample-data/test-step](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-sample-data-test-step): Test a flow step with sample data
- [GET /v1/tables](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-tables): List tables
- [GET /v1/tables/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-tables-id): Get a table by ID
- [POST /v1/tables/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-tables-id): Update a table
- [DELETE /v1/tables/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-tables-id): Delete a table
- [POST /v1/tables/{id}/clear](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-tables-id-clear): Clear all records from a table
- [GET /v1/tables/{id}/export](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-tables-id-export): Export a table
- [GET /v1/tables/{id}/template](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-tables-id-template): Get a table template
- [POST /v1/tables/{id}/webhooks](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-tables-id-webhooks): Create a table webhook
- [DELETE /v1/tables/{id}/webhooks/{webhookId}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-tables-id-webhooks-webhookid): Delete a table webhook
- [GET /v1/tables/count](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-tables-count): Get a table count
- [GET /v1/templates](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-templates): List templates
- [POST /v1/templates](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-templates): Create a template
- [GET /v1/templates/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-templates-id): Get a template
- [POST /v1/templates/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-templates-id): Update a template
- [DELETE /v1/templates/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-templates-id): Delete a template
- [GET /v1/templates/categories](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-templates-categories): List template categories
- [GET /v1/user-invitations](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-user-invitations): List user invitations
- [POST /v1/user-invitations](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-user-invitations): Send a user invitation
- [DELETE /v1/user-invitations/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-user-invitations-id): Delete a user invitation
- [GET /v1/users](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-users): List users
- [GET /v1/users/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-users-id): Get a user by ID
- [POST /v1/users/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-users-id): Update a user
- [DELETE /v1/users/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-users-id): Delete a user
- [GET /v1/variables](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-variables): List project variables
- [POST /v1/variables](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-variables): Create a project variable
- [POST /v1/variables/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/post-v1-variables-id): Update a project variable
- [DELETE /v1/variables/{id}](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/delete-v1-variables-id): Delete a project variable
- [GET /v1/worker-machines/queue-metrics](https://octri-at67uffqbqdc.octri.dev/api-reference/v1/get-v1-worker-machines-queue-metrics): Get worker machine queue metrics

## Optional
- [Changelog](https://octri-at67uffqbqdc.octri.dev/changelog): API version history and breaking changes