---
title: "POST /projects/"
method: POST
path: "/projects/"
tags: ["projects"]
---

# POST /projects/

`POST /projects/`

Import a project.

## Request body

- ProjectCreateRequest
  - `url` string, required
  - `proxy` string
  - `name` string, required
  - `description` string
  - `organization_id` integer, nullable
  - `eda_credential_id` integer, nullable
  - `signature_validation_credential_id` integer, nullable
  - `verify_ssl` boolean
  - `scm_type` 'git' — * `git` - Git
  - `scm_branch` string
  - `scm_refspec` string

## Response `201`

Return a created project.

- Project
  - `name` string, required
  - `description` string
  - `organization_id` integer, nullable, required
  - `eda_credential_id` integer, nullable
  - `signature_validation_credential_id` integer, nullable, required
  - `scm_branch` string
  - `scm_refspec` string
  - `verify_ssl` boolean
  - `proxy` string, required
  - `id` integer, required
  - `url` string, required
  - `scm_type` 'git', required — * `git` - Git
  - `git_hash` string, required
  - `import_state` 'pending' | 'running' | 'failed' | 'completed', required — * `pending` - Pending * `running` - Running * `failed` - Failed * `completed` - Completed
  - `import_error` string, nullable, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

## Changes

- **2024-04-23** `cbf68ddd9760` — 1 breaking, 4 warning, 30 info
  - removed the required property `import_task_id` from the response with the `201` status
  - removed the request property `credential_id` (media type: application/json)
  - removed the request property `credential_id` (media type: application/x-www-form-urlencoded)
  - removed the request property `credential_id` (media type: multipart/form-data)
  - …31 more
- **2023-09-05** `011f9cfbad09` — 4 info
  - added the new optional request property `verify_ssl` (media type: application/json)
  - added the new optional request property `verify_ssl` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `verify_ssl` (media type: multipart/form-data)
  - added the optional property `verify_ssl` to the response with the `201` status
- **2023-08-21** `c84b4813cab1` — 1 breaking, 2 info
  - the response property `credential_id` became optional for the status `201`
  - the endpoint scheme security `cookieAuth` was added to the API
  - the response required property `credential_id` became not read-only for the status `201`
- …earlier changes not shown

[Full history](https://skmtc.dev/ansible/apis/event-driven-ansible-api/changes/projects/post.md)

---

[API](https://skmtc.dev/ansible/apis/event-driven-ansible-api.md) · [All operations](https://skmtc.dev/ansible/apis/event-driven-ansible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ansible/event-driven-ansible-api/revisions/c04fc5f09692/schema)