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

# POST /projects/

`POST /projects/`

Import a project.

## Request body

- ProjectCreateRequest
  - `url` string, required
  - `name` string, required
  - `description` string
  - `credential_id` integer, nullable

## Response `201`

Return a created project.

- Project
  - `name` string, required
  - `description` string
  - `credential_id` integer, nullable, required
  - `id` integer, required
  - `url` string, required
  - `git_hash` string, required
  - `import_state` 'pending' | 'running' | 'failed' | 'completed', required — * `pending` - Pending * `running` - Running * `failed` - Failed * `completed` - Completed
  - `import_error` string, nullable, required
  - `import_task_id` string, uuid, nullable, required
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

## Changes

- **2023-05-19** `f84d9240fdf2` — 5 info
  - the endpoint scheme security `cookieAuth` was removed from the API
  - added the new optional request property `credential_id` (media type: application/json)
  - added the new optional request property `credential_id` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `credential_id` (media type: multipart/form-data)
  - …1 more
- **2023-04-25** `62d33b790834` — 4 breaking, 28 warning, 3 info
  - removed the required property `organization_id` from the response with the `201` status
  - removed the required property `proxy` from the response with the `201` status
  - removed the required property `scm_type` from the response with the `201` status
  - removed the required property `signature_validation_credential_id` from the response with the `201` status
  - …31 more

[Change 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/f84d9240fdf2/schema)