COcomposiohq
Projects

Create a new project

Changed on

Creates a new project within the authenticated user's organization using the specified name. Projects are isolated environments within your organization, each with their own API keys, webhook configurations, and resources. Use this endpoint to create additional projects for different environments (e.g., development, staging, production) or for separate applications.

post/api/v3.1/org/owner/project/new

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/org/owner/project/new
  • Auth
    API key in header x-org-api-key

Request body

namestring required

A unique name for your project that follows the required format rules

should_create_api_keyboolean

Whether to create an API key for the project. If true, the API key will be created and returned in the response.

api_key_allowed_ipsstring[]

IPv4 or IPv6 addresses allowed to use the project API key. Requires should_create_api_key to be true. Omit to allow requests from any IP address.

Example request

{
  "name": "my-awesome-project",
  "api_key_allowed_ips": [
    "203.0.113.10"
  ],
  "api_key_permissions": [
    {
      "preset": "tool_execution",
      "access": "write"
    }
  ]
}

Response

Project successfully created. Returns the complete project object with generated IDs, webhook secrets, and configuration.

idstring projectId required

Unique identifier for the project

namestring

Name of the project

api_keystring nullable required

API key for the project

Example response

{
  "id": "pr_1a2b3c4d5e6f",
  "name": "My Awesome Project",
  "api_key": "ak_a1b2c3d4e5f6g7h8i9j0"
}

Changes

  • d0a2f1ee8fd2Revision changes
    • info

      added the new optional request property /

  • 98956f31abf3Revision changes
    • warning

      removed the request property /

    • info

      api operation id postV3_1OrgOwnerProjectNew removed and replaced with postOrgOwnerProjectNew

    • info

      api tag Organization removed

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status