---
title: "Convert all Runbooks to be stored in Git rather than the database."
method: POST
path: "/{spaceId}/projects/{projectId}/git/migrate-runbooks"
tags: ["Projects"]
---

# Convert all Runbooks to be stored in Git rather than the database.

`POST /{spaceId}/projects/{projectId}/git/migrate-runbooks`

## Path parameters

- `spaceId` string, required
- `projectId` string, required

## Request body

- ConvertProjectRunbooksToGitCommand
  - `Branch` string — Branch to commit the migrated Runbooks to. Required if there are Runbooks to migrate.
  - `CommitMessage` string — Commit message to use when committing the migrated Runbooks to Git. Required if there are Runbooks to migrate
  - `CreateBranch` boolean
  - `ProjectId` string, required
  - `SpaceId` string, required — The ID of the space containing the resource(s).

## Response `200`

Indicates that the project runbooks were converted to Git

- ConvertProjectRunbooksToGitResponse
  - `DraftRunbooks` RunbookSummary[], required
    - `RunbookId` string
    - `RunbookName` string
  - `PublishedRunbooks` RunbookSummary[], required
    - `RunbookId` string
    - `RunbookName` string
  - `ServerTaskId` string

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/revisions/b296c3a60aa5/schema)