Projects API

A project represents a single ADO → Jira migration initiative. It holds the platform connections, mapping configuration, and links to all migration runs.

Create a Project

POST /api/projects

Request body:

{
  "name":         "Acme Corp ADO → Jira",
  "sourceSystem": "AZURE_DEVOPS",
  "targetSystem": "JIRA",
  "description":  "Full migration of the Platform team project"
}

Response (201 Created):

{
  "id":           "project-uuid",
  "tenantId":     "tenant-uuid",
  "name":         "Acme Corp ADO → Jira",
  "sourceSystem": "AZURE_DEVOPS",
  "targetSystem": "JIRA",
  "status":       "DRAFT",
  "createdAt":    "2024-06-03T10:00:00Z"
}

List Projects

GET /api/projects

Returns all projects for the authenticated tenant, most recent first.

Response:

[
  {
    "id":        "project-uuid",
    "name":      "Acme Corp ADO → Jira",
    "status":    "COMPLETED",
    "createdAt": "2024-06-03T10:00:00Z",
    "updatedAt": "2024-06-03T14:30:00Z"
  }
]

Get a Project

GET /api/projects/{projectId}

Returns the project including the latest scan summary and quote if available.

Project Status Values

Status	Description
`DRAFT`	Created but platforms not yet connected
`CONNECTED`	Both platforms connected
`SCANNED`	ADO project scanned; scan summary available
`MAPPED`	All mappings confirmed
`READY`	Paid and ready to migrate
`MIGRATING`	Migration currently running
`COMPLETED`	Migration finished successfully
`FAILED`	Migration encountered a terminal error
`CANCELLED`	Migration was cancelled by the user

Delete a Project

DELETE /api/projects/{projectId}

Deletes the project and all associated migration runs, mappings, and scan data. Does not delete any data from ADO or Jira.

Response: 204 No Content

Authentication Migrations