Skip to Content
webagent docs
API reference

Projects

Projects inside an organization.

Open as .md
GET
/v1/orgs/{orgId}/projects

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

orgId*string
Match^ten_(us|in)_[0-9a-z]{24}$

Response Body

OK

application/json
  1. response
projects*array<>
Example Request
curl -X GET 'https://api.us.webagent.lookover.ai/v1/orgs/string/projects'
Example Response
{  "projects": [    {      "id": "string",      "tenantId": "string",      "name": "string",      "isDefault": true,      "createdAt": 0    }  ]}

Create a project (admin)

POST
/v1/orgs/{orgId}/projects

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

orgId*string
Match^ten_(us|in)_[0-9a-z]{24}$

Request Body

application/json
  1. body
name*string
Length1 <= length <= 100

Response Body

OK

application/json
  1. response
id*string
Match^prj_(us|in)_[0-9a-z]{24}$
tenantId*string
Match^ten_(us|in)_[0-9a-z]{24}$
name*string
Length1 <= length <= 100
isDefault*boolean
createdAt*integer
Range0 <= value <= 9007199254740991
Example Request
curl -X POST 'https://api.us.webagent.lookover.ai/v1/orgs/string/projects' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "id": "string",  "tenantId": "string",  "name": "string",  "isDefault": true,  "createdAt": 0}

Rename a project (admin)

PATCH
/v1/orgs/{orgId}/projects/{projectId}

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

orgId*string
Match^ten_(us|in)_[0-9a-z]{24}$
projectId*string
Match^prj_(us|in)_[0-9a-z]{24}$

Request Body

application/json
  1. body
name*string
Length1 <= length <= 100

Response Body

OK

application/json
  1. response
id*string
Match^prj_(us|in)_[0-9a-z]{24}$
tenantId*string
Match^ten_(us|in)_[0-9a-z]{24}$
name*string
Length1 <= length <= 100
isDefault*boolean
createdAt*integer
Range0 <= value <= 9007199254740991
Example Request
curl -X PATCH 'https://api.us.webagent.lookover.ai/v1/orgs/string/projects/string' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response
{  "id": "string",  "tenantId": "string",  "name": "string",  "isDefault": true,  "createdAt": 0}

Delete a project

DELETE
/v1/orgs/{orgId}/projects/{projectId}

Delete a project (admin). Refused (409 conflict) for the default project and while it still holds anything (active keys, sessions, skill runs, webhooks, schedules, MCP servers, installed skills, credentials, profiles, inboxes); details has reason: not_empty and a count per kind

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

orgId*string
Match^ten_(us|in)_[0-9a-z]{24}$
projectId*string
Match^prj_(us|in)_[0-9a-z]{24}$

Response Body

OK

application/json
  1. response
deleted*boolean
Example Request
curl -X DELETE 'https://api.us.webagent.lookover.ai/v1/orgs/string/projects/string'
Example Response
{  "deleted": true}