Skip to main content
POST
/
api
/
v1
/
projects
Create project
curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "settings_md": "<string>",
  "tags": [
    "<string>"
  ],
  "type": "shared"
}
'
{
  "project": {
    "created_at": "2023-11-07T05:31:56Z",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "member_count": 1,
    "name": "<string>",
    "owner_email": "jsmith@example.com",
    "settings_md": "<string>",
    "shared_with_team": true,
    "tags": [
      "<string>"
    ],
    "task_count": 1,
    "updated_at": "2023-11-07T05:31:56Z",
    "cap_percent_used": 123,
    "cap_used_usd": 123,
    "is_owner": true,
    "issue_count": 1,
    "issues_by_severity": [
      {
        "count": 123,
        "label": "<string>"
      }
    ],
    "issues_by_status": [
      {
        "count": 123,
        "label": "<string>"
      }
    ],
    "shared_team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "spending_cap_usd": 123
  }
}

Authorizations

Authorization
string
header
required

JWT authentication token

Body

application/json
id
string<uuid>

Optional. Client-supplied project UUID. If omitted, the server generates one. If a project with this id already exists, the request is rejected with 409.

name
string

Optional. Project name. If omitted or empty the server stores an empty name and may generate one asynchronously from the first task.

Maximum string length: 128
settings_md
string

Optional initial project settings markdown. Values longer than 35k characters are truncated by the API and suffixed with "[truncated] max char limit 35k".

tags
string[]

Optional. Initial tags. Capped at 20. The agent merges additional tags onto this set asynchronously.

type
enum<string>
default:shared

Optional. Workspace type, fixed at creation and cannot be changed later. 'shared' (default) runs in the common team workspace and is shared with the whole team. 'dedicated' uses an isolated, private workspace accessible only to invited members.

Available options:
shared,
dedicated

Response

Project created

project
object
required