Create a project
post
/v1/projectsOAuth scopes
- projects:write
The fine-grained token must include the following permissions to access this endpoint:
- organization_projects_create
Body
- db_passRequiredstring
- nameRequiredstring
- organization_idOptionalDeprecatedstring
- organization_slugRequiredstring
- planOptionalDeprecatedenum
- regionOptionalDeprecatedenum
- region_selectionOptionalone of the following options
- kps_enabledOptionalDeprecatedboolean
- desired_instance_sizeOptionalenum
- template_urlOptionalstring
- release_channelOptionalDeprecatedunknown
- postgres_engineOptionalDeprecatedunknown
- high_availabilityOptionalboolean
Response codes
- 201
- 401
- 403
- 429
Response (201)
{ "id": "lorem", "ref": "abcdefghijklmnopqrst", "organization_id": "lorem", "organization_slug": "tsrqponmlkjihgfedcba", "name": "lorem", "region": "lorem", "created_at": "lorem", "status": "INACTIVE"}{ "type": "object", "properties": { "id": { "type": "string", "deprecated": true, "description": "Deprecated: Use `ref` instead." }, "ref": { "type": "string", "minLength": 20, "maxLength": 20, "pattern": "^[a-z]+$", "description": "Project ref", "example": "abcdefghijklmnopqrst" }, "organization_id": { "type": "string", "description": "Deprecated: Use `organization_slug` instead.", "deprecated": true }, "organization_slug": { "type": "string", "pattern": "^[\\w-]+$", "description": "Organization slug", "example": "tsrqponmlkjihgfedcba" }, "name": { "type": "string", "description": "Name of your project" }, "region": { "type": "string", "description": "Region of your project" }, "created_at": { "type": "string", "description": "Creation timestamp" }, "status": { "type": "string", "enum": [ "INACTIVE", "ACTIVE_HEALTHY", "ACTIVE_UNHEALTHY", "COMING_UP", "UNKNOWN", "GOING_DOWN", "INIT_FAILED", "REMOVED", "RESTORING", "UPGRADING", "PAUSING", "RESTORE_FAILED", "RESTARTING", "PAUSE_FAILED", "RESIZING" ] } }, "required": [ "id", "ref", "organization_id", "organization_slug", "name", "region", "created_at", "status" ]}