> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instacloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Provision a project (DB + storage + compute)

> **Token scope:** `account` · `org` — read-only tokens refused (not a GET).



## OpenAPI

````yaml /openapi/org.json post /orgs/{orgId}/projects
openapi: 3.1.0
info:
  title: InstaCloud API — Organization level
  version: 0.1.0
  description: >-
    Endpoints under `/orgs/{orgId}`: members, projects, billing, domains.
    Callable with an account-wide token or a token bound to that organization.


    Generated from the platform's own OpenAPI document
    (https://api.instacloud.com/openapi.json); see the [API
    overview](/reference/api/overview) for authentication and token scopes.
servers:
  - url: https://api.instacloud.com
    description: InstaCloud
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: 'The organization itself: name, members, invitations.'
  - name: Projects
    description: Projects inside an organization.
  - name: Audit
    description: The project's event timeline, including agent-ingested events.
  - name: Domains
    description: >-
      Domains bought through InstaCloud, bring-your-own zones and their DNS
      records.
  - name: Billing
    description: Usage, cycles, invoices and credits.
paths:
  /orgs/{orgId}/projects:
    post:
      tags:
        - Projects
      summary: Provision a project (DB + storage + compute)
      description: >-
        **Token scope:** `account` · `org` — read-only tokens refused (not a
        GET).
      operationId: createProject
      parameters:
        - schema:
            format: uuid
            type: string
          in: path
          name: orgId
          required: true
      requestBody:
        content:
          application/json:
            schema:
              required:
                - name
              type: object
              properties:
                name:
                  type: string
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProvisionResult'
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ProvisionResult:
      type: object
      properties:
        project:
          $ref: '#/components/schemas/Project'
        defaultBranch:
          type: object
          properties:
            id:
              format: uuid
              type: string
            name:
              type: string
        resources:
          type: array
          items:
            type: object
            properties:
              kind:
                $ref: '#/components/schemas/ResourceKind'
              provider:
                $ref: '#/components/schemas/ComputeProvider'
              status:
                type: string
        nextActions:
          type: array
          items:
            $ref: '#/components/schemas/NextAction'
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
    Project:
      type: object
      properties:
        id:
          format: uuid
          type: string
        org_id:
          format: uuid
          type: string
        owner_user_id:
          description: Better Auth user id (opaque string, not a UUID)
          type: string
        name:
          type: string
        status:
          type: string
          enum:
            - active
            - error
            - deleting
            - deleted
        created_at:
          format: date-time
          type: string
    ResourceKind:
      type: string
      enum:
        - neon
        - insta-db
        - s3
        - fly
        - insta-compute
    ComputeProvider:
      description: >-
        Compute plane actually backing a compute resource, derived from its
        provider_ref rather than its kind. Absent when it cannot be determined
        from the row — clients must then assert no provider rather than assume
        one from `kind`.
      type: string
      enum:
        - fly
        - insta-compute
    NextAction:
      type: object
      properties:
        op:
          description: >-
            Neutral logical action id, e.g. "service.add" — NOT an operationId
            or a CLI/MCP tool name; each client maps it to its own surface.
          type: string
        reason:
          description: Natural-language, human/LLM-facing "why do this now".
          type: string
        args:
          description: >-
            Suggested, flat named arguments; "<placeholder>"s where a value is
            unknown.
          type: object
          additionalProperties: true
        gated:
          description: True if the action passes a governance gate.
          type: boolean
      required:
        - op
        - reason
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session access JWT or an API token (`insta_<prefix>_<secret>`).

````