Create project

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.organizations.projects.create({
  path: {
    organizationId: "organizationId",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
  body: {
    name: "name",
    slug: "slug",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import CreateProjectInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.organizations.projects.create(
    CreateProjectInput.model_validate({
        "path": {
            "organizationId": "organizationId",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "name": "name",
            "slug": "slug",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .create_project(
        "idempotencyKey".to_owned(),
        "organizationId".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "name": "name",
            "slug": "slug",
        }))?,
    )
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.organizations.projects.create({
  path: {
    organizationId: "organizationId",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
  body: {
    name: "name",
    slug: "slug",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import CreateProjectInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.organizations.projects.create(
    CreateProjectInput.model_validate({
        "path": {
            "organizationId": "organizationId",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "name": "name",
            "slug": "slug",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .create_project(
        "idempotencyKey".to_owned(),
        "organizationId".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "name": "name",
            "slug": "slug",
        }))?,
    )
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

POST /v1/organizations/{organizationId}/projects Creates in the authorized organization. In addition to account credentials, explicitly granted Service Identity API keys and M2M tokens may create projects. Project API keys cannot create projects. Creator and private credential evidence come only from the trusted authorization context. The caller-selected slug is immutable, must be 3 to 63 lowercase ASCII alphanumerics separated by single hyphens, and cannot be reserved or held by any active or deleted project.

TypeScript
Python
Rust

TypeScript

photon.organizations.projects.create(input: CreateProjectInput, options?: RequestOptions): Promise<CreateProjectOutput>

Python

photon.organizations.projects.create(input: CreateProjectInput) -> models.Project

Rust

client.create_project(idempotency_key: String, organization_id: String, body: &types::CreateProjectRequest).await -> Result<ResponseValue<CreateProjectResponse>, Error<CreateProjectError>>

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.organizations.projects.create({
  path: {
    organizationId: "organizationId",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
  body: {
    name: "name",
    slug: "slug",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import CreateProjectInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.organizations.projects.create(
    CreateProjectInput.model_validate({
        "path": {
            "organizationId": "organizationId",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "name": "name",
            "slug": "slug",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .create_project(
        "idempotencyKey".to_owned(),
        "organizationId".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "name": "name",
            "slug": "slug",
        }))?,
    )
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "agentProfile": {
    "avatarUrl": "https://example.com",
    "firstName": "string",
    "lastName": null
  },
  "billingInitialization": "pending",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "createdByAccountId": null,
  "createdByActorId": null,
  "createdByActorKind": null,
  "deletedAt": null,
  "name": "string",
  "organizationId": "string",
  "projectId": "string",
  "slug": "string",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Parameters

string

required

Identifies one logical mutation across retries.

string

required

Body

string

required

string

required

Returns

201 The created project, ready to use: its billingInitialization is completed or unknown. A replay after setup finished answers here too. Project

AgentProfile

required

ProjectBillingInitialization

string (date-time)

required

string | null

required

string | null

required

ProjectCreatedByActorKind | null

required

string (date-time) | null

required

string

required

string

required

string

required

string

required

string (date-time)

required

202 The project is created but its billing is still being set up. GET the Location after the Retry-After interval until billingInitialization is completed or unknown; retry_required means setup is being retried, so keep polling. Project Headers: Location. The raw response carries these headers; see Raw responses.

AgentProfile

required

ProjectBillingInitialization

string (date-time)

required

string | null

required

string | null

required

ProjectCreatedByActorKind | null

required

string (date-time) | null

required

string

required

string

required

string

required

string

required

string (date-time)

required

⌘I

Get started

Guides

Reference

SDK reference

Create project

Parameters

Body

Returns

​Parameters

​Body

​Returns

Parameters

Body

Returns