> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.athenaintel.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.athenaintel.com/_mcp/server. # Create Project POST https://api.athenaintel.com/api/v0/assets/create_project Content-Type: application/json Create a new project with custom metadata. Projects can be typed (e.g., 'candidate', 'user', 'company') and include flexible custom metadata for storing additional information. Reference: https://docs.athenaintel.com/api-reference/assets/create-project ## Authentication - `X-API-KEY` header (required) — API Key authentication via header ## Request ### Body (application/json) This endpoint expects a CreateProjectRequestIn. - `title` (string, required) — The project title - `custom_metadata` (map from string to any, optional, nullable) — A flexible dictionary for storing custom metadata - `description` (string, optional, nullable) — Optional project description - `parent_folder_id` (string, optional, nullable) — Optional parent folder ID - `project_type` (string, optional, nullable) — User-defined project type (e.g., 'candidate', 'user', 'company') - `share_with_emails` (list of string, optional, nullable) — Optional list of email addresses to share the project with (VIEW permission) - `tags` (list of string, optional, nullable) — Optional list of tags for categorizing the project ## Response ### 200 Project created successfully - `asset_id` (string, required) — ID of the created project asset - `title` (string, required) — Title of the created project - `custom_metadata` (map from string to any, optional, nullable) — Custom metadata associated with the project - `description` (string, optional, nullable) — Description of the project - `project_type` (string, optional, nullable) — Type of the project - `tags` (list of string, optional, nullable) — Tags associated with the project ## Errors ### 400 Bad Request Error Invalid request parameters, or parent_folder_id is not a live folder or Drive in the caller's current workspace (not a folder, archived, or in another workspace). Nothing is created. - `map from string to any` ### 403 Forbidden Error The caller cannot see parent_folder_id, or cannot edit it (or the Drive it is in). Nothing is created. - `any` ### 422 Unprocessable Entity Error Validation Error - `detail` (list of ValidationError, optional) ### 429 Too Many Requests Error Project creation rate limit exceeded. Retry-After contains the remaining fixed-window duration in seconds. - `map from string to any` ### 500 Internal Server Error Internal server error during project creation - `map from string to any` ## Types ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) - `ctx` (ValidationErrorCtx, optional) - `input` (any, optional) ### ValidationErrorLocItems - string - integer ### ValidationErrorCtx ## Examples **Request** ```json { "title": "John Doe - Software Engineer", "custom_metadata": { "email": "john.doe@example.com", "phone": "+1-555-0123", "source": "linkedin", "status": "active" }, "description": "Candidate profile for senior software engineer position", "parent_folder_id": "asset_folder_123", "project_type": "candidate", "share_with_emails": [ "colleague@example.com", "manager@example.com" ], "tags": [ "engineering", "senior", "active" ] } ``` **Response** ```json { "asset_id": "asset_project_abc123", "title": "John Doe - Software Engineer", "custom_metadata": { "email": "john.doe@example.com", "phone": "+1-555-0123", "source": "linkedin", "status": "active" }, "description": "Candidate profile for senior software engineer position", "project_type": "candidate" } ``` **SDK Code** ```python assets_create_project_example import requests url = "https://api.athenaintel.com/api/v0/assets/create_project" payload = { "title": "John Doe - Software Engineer", "custom_metadata": { "email": "john.doe@example.com", "phone": "+1-555-0123", "source": "linkedin", "status": "active" }, "description": "Candidate profile for senior software engineer position", "parent_folder_id": "asset_folder_123", "project_type": "candidate", "share_with_emails": ["colleague@example.com", "manager@example.com"], "tags": ["engineering", "senior", "active"] } headers = { "X-API-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript assets_create_project_example const url = 'https://api.athenaintel.com/api/v0/assets/create_project'; const options = { method: 'POST', headers: {'X-API-KEY': '', 'Content-Type': 'application/json'}, body: '{"title":"John Doe - Software Engineer","custom_metadata":{"email":"john.doe@example.com","phone":"+1-555-0123","source":"linkedin","status":"active"},"description":"Candidate profile for senior software engineer position","parent_folder_id":"asset_folder_123","project_type":"candidate","share_with_emails":["colleague@example.com","manager@example.com"],"tags":["engineering","senior","active"]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go assets_create_project_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.athenaintel.com/api/v0/assets/create_project" payload := strings.NewReader("{\n \"title\": \"John Doe - Software Engineer\",\n \"custom_metadata\": {\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1-555-0123\",\n \"source\": \"linkedin\",\n \"status\": \"active\"\n },\n \"description\": \"Candidate profile for senior software engineer position\",\n \"parent_folder_id\": \"asset_folder_123\",\n \"project_type\": \"candidate\",\n \"share_with_emails\": [\n \"colleague@example.com\",\n \"manager@example.com\"\n ],\n \"tags\": [\n \"engineering\",\n \"senior\",\n \"active\"\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-API-KEY", "") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby assets_create_project_example require 'uri' require 'net/http' url = URI("https://api.athenaintel.com/api/v0/assets/create_project") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-API-KEY"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"title\": \"John Doe - Software Engineer\",\n \"custom_metadata\": {\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1-555-0123\",\n \"source\": \"linkedin\",\n \"status\": \"active\"\n },\n \"description\": \"Candidate profile for senior software engineer position\",\n \"parent_folder_id\": \"asset_folder_123\",\n \"project_type\": \"candidate\",\n \"share_with_emails\": [\n \"colleague@example.com\",\n \"manager@example.com\"\n ],\n \"tags\": [\n \"engineering\",\n \"senior\",\n \"active\"\n ]\n}" response = http.request(request) puts response.read_body ``` ```java assets_create_project_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.athenaintel.com/api/v0/assets/create_project") .header("X-API-KEY", "") .header("Content-Type", "application/json") .body("{\n \"title\": \"John Doe - Software Engineer\",\n \"custom_metadata\": {\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1-555-0123\",\n \"source\": \"linkedin\",\n \"status\": \"active\"\n },\n \"description\": \"Candidate profile for senior software engineer position\",\n \"parent_folder_id\": \"asset_folder_123\",\n \"project_type\": \"candidate\",\n \"share_with_emails\": [\n \"colleague@example.com\",\n \"manager@example.com\"\n ],\n \"tags\": [\n \"engineering\",\n \"senior\",\n \"active\"\n ]\n}") .asString(); ``` ```php assets_create_project_example request('POST', 'https://api.athenaintel.com/api/v0/assets/create_project', [ 'body' => '{ "title": "John Doe - Software Engineer", "custom_metadata": { "email": "john.doe@example.com", "phone": "+1-555-0123", "source": "linkedin", "status": "active" }, "description": "Candidate profile for senior software engineer position", "parent_folder_id": "asset_folder_123", "project_type": "candidate", "share_with_emails": [ "colleague@example.com", "manager@example.com" ], "tags": [ "engineering", "senior", "active" ] }', 'headers' => [ 'Content-Type' => 'application/json', 'X-API-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp assets_create_project_example using RestSharp; var client = new RestClient("https://api.athenaintel.com/api/v0/assets/create_project"); var request = new RestRequest(Method.POST); request.AddHeader("X-API-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"title\": \"John Doe - Software Engineer\",\n \"custom_metadata\": {\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1-555-0123\",\n \"source\": \"linkedin\",\n \"status\": \"active\"\n },\n \"description\": \"Candidate profile for senior software engineer position\",\n \"parent_folder_id\": \"asset_folder_123\",\n \"project_type\": \"candidate\",\n \"share_with_emails\": [\n \"colleague@example.com\",\n \"manager@example.com\"\n ],\n \"tags\": [\n \"engineering\",\n \"senior\",\n \"active\"\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift assets_create_project_example import Foundation let headers = [ "X-API-KEY": "", "Content-Type": "application/json" ] let parameters = [ "title": "John Doe - Software Engineer", "custom_metadata": [ "email": "john.doe@example.com", "phone": "+1-555-0123", "source": "linkedin", "status": "active" ], "description": "Candidate profile for senior software engineer position", "parent_folder_id": "asset_folder_123", "project_type": "candidate", "share_with_emails": ["colleague@example.com", "manager@example.com"], "tags": ["engineering", "senior", "active"] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.athenaintel.com/api/v0/assets/create_project")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```