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>"
  ]
}
'
{
  "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",
    "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"
  }
}

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 asynchronously generates one from the first task's message (see generateProjectMetadata).

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.

Response

Project created

project
object
required