Skip to main content

​
List Projects

List all projects within an organization.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization

​
Response

​
projects
array
Array of project objects with membership details
curl --location --request GET 'https://api.plaisolutions.com/organizations/org_123/projects' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Create Project

Create a new project within an organization.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization

​
Request Body

​
name
string
required
Project name
​
description
string
Project description
​
allowed_domains
array
required
Array of domains allowed for this project (e.g., [“example.com”, “subdomain.example.com”])

​
Response

Returns the created project object with membership details. 
curl --location --request POST 'https://api.plaisolutions.com/organizations/org_123/projects' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "My AI Project",
  "description": "A project for building AI agents",
  "allowed_domains": ["mycompany.com", "app.mycompany.com"]
}'

​
Get Project

Get a single project by ID.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization
​
project_id
string
required
The unique identifier of the project

​
Response

Returns the project object with membership details. 
curl --location --request GET 'https://api.plaisolutions.com/organizations/org_123/projects/proj_456' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Update Project

Update an existing project.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization
​
project_id
string
required
The unique identifier of the project

​
Request Body

​
name
string
Updated project name
​
description
string
Updated project description
​
allowed_domains
array
Updated array of domains allowed for this project

​
Response

Returns the updated project object. 
curl --location --request PATCH 'https://api.plaisolutions.com/organizations/org_123/projects/proj_456' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "Updated Project Name",
  "description": "Updated description"
}'

​
Delete Project

Delete a project. This action cannot be undone and will remove all associated agents, datasources, and other project resources.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization
​
project_id
string
required
The unique identifier of the project

​
Response

Returns a 204 status code on successful deletion.
Deleting a project is irreversible and will permanently remove all associated data including agents, datasources, tools, and usage history.
curl --location --request DELETE 'https://api.plaisolutions.com/organizations/org_123/projects/proj_456' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Get Project Statistics

Get statistics and metrics for a project.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization
​
project_id
string
required
The unique identifier of the project

​
Response

​
agents
integer
Total number of agents in the project
​
datasources
integer
Total number of datasources in the project
​
resources
integer
Total number of resources across all datasources
​
tools
integer
Total number of tools in the project
​
requests
integer
Total number of API requests made in the project
curl --location --request GET 'https://api.plaisolutions.com/organizations/org_123/projects/proj_456/stats' \
--header 'Authorization: Bearer YOUR_TOKEN'

{
  "agents": 5,
  "datasources": 3,
  "resources": 127,
  "tools": 8,
  "requests": 1543
}

​
List Project Members

List all members of a project.

​
Path Parameters

​
organization_id
string
required
The unique identifier of the organization
​
project_id
string
required
The unique identifier of the project

​
Response

​
members
array
Array of member objects
curl --location --request GET 'https://api.plaisolutions.com/organizations/org_123/projects/proj_456/members' \
--header 'Authorization: Bearer YOUR_TOKEN'

​
Project Roles

Projects support a hierarchical role-based access control system:
  • Full control over the project
  • Can delete the project
  • Can manage all members and their roles
  • Can modify all project settings
  • Can access all project resources
  • Can manage project settings (except deletion)
  • Can invite and remove members
  • Can modify member roles (except OWNER)
  • Can access all project resources
  • Can create and modify agents, tools, and datasources
  • Can create and modify agents, tools, and datasources
  • Can access project resources based on permissions
  • Cannot manage project settings or members
  • Can view project statistics
  • Read-only access to project resources
  • Can view agents, tools, and datasources
  • Cannot create or modify any resources
  • Can view project statistics
Each project membership includes an API token that can be used for programmatic access to the project’s resources. This token inherits the permissions of the user’s role in the project.