Create a project

POST/openapi/v1/projects

POST /openapi/v1/projects
Authorization: Bearer <API_KEY>
Content-Type: application/json

Request parameters

Parameter	Location	Type	Required	Description
`name`	Body	`string`	Yes	Project name, 1–200 characters after trimming

Request body example

{

"name": "Advertising Assets"

}

stringRequired; project name, 1–200 characters after trimming

The body accepts only name. Additional top-level fields return INVALID_REQUEST. Project names do not need to be unique; use the returned data.id as the Project ID. Every call creates a new project.

The success status is HTTP 201.

Success response example

{

"code": 200,

"message": "success",

"data": {

"id": "PROJECT_ID",

"name": "Advertising Assets"

}

integerProtocol field, currently fixed at 200

stringFixed at success on success

objectNewly created project

stringProject ID; pass it as projectId when creating a Run

stringProject name

Code examples

The examples below use the MAXDAY_API_KEY environment variable.

curl --fail-with-body --request POST "https://api.maxday.ai/bio/dramas/v1/openapi/v1/projects" \
  --header "Authorization: Bearer ${MAXDAY_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{"name":"Advertising Assets"}'

const response = await fetch("https://api.maxday.ai/bio/dramas/v1/openapi/v1/projects", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MAXDAY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Advertising Assets" }),
});
const body = await response.json();

if (!response.ok || body.message !== "success") {
  throw new Error(body.data?.error?.message || body.message || `HTTP ${response.status}`);
}
console.log(body.data);

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://api.maxday.ai/bio/dramas/v1/openapi/v1/projects",
    data=json.dumps({"name": "Advertising Assets"}).encode("utf-8"),
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["MAXDAY_API_KEY"],
        "Content-Type": "application/json",
    },
)

with urlopen(request, timeout=60) as response:
    body = json.load(response)

if body.get("message") != "success":
    error = body.get("data", {}).get("error", {})
    raise RuntimeError(error.get("message") or body.get("message"))
print(json.dumps(body["data"], ensure_ascii=False, indent=2))

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Map;

public final class CreateProjectExample {
  public static void main(String[] args) throws Exception {
    ObjectMapper json = new ObjectMapper();
    String requestBody = json.writeValueAsString(Map.of("name", "Advertising Assets"));
    HttpRequest request = HttpRequest.newBuilder(
            URI.create("https://api.maxday.ai/bio/dramas/v1/openapi/v1/projects"))
        .header("Authorization", "Bearer " + System.getenv("MAXDAY_API_KEY"))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(requestBody))
        .build();
    HttpResponse<String> response = HttpClient.newHttpClient().send(
        request,
        HttpResponse.BodyHandlers.ofString()
    );
    JsonNode body = json.readTree(response.body());

    if (response.statusCode() < 200 || response.statusCode() >= 300
        || !"success".equals(body.path("message").asText())) {
      throw new IllegalStateException(
          body.path("data").path("error").path("message").asText(
              body.path("message").asText("HTTP " + response.statusCode())
          )
      );
    }
    System.out.println(body.path("data").toPrettyString());
  }
}