thesis API

REST API for managing projects, deployments, and users.

Base URLhttps://api.thesis.io/v1

Projects

get/projects

List projects

Returns a paginated list of all projects the authenticated user has access to.

Parameters

pageoptional, integer

Page number

limitoptional, integer

Items per page

Responses

200Successful response

Response

{
  "data": [
    {
      "id": "id_1a2b3c",
      "name": "Project name",
      "description": "Project description",
      "status": "active",
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 1
}

post/projects

Create a project

Creates a new project under the authenticated user's organization.

Request Body

namerequired, string

Project name

descriptionoptional, string

Optional project description

templateoptional, string

Template to use

Enum: "default", "react", "node", "static"

Responses

201Project created

400Validation error

Response

{
  "id": "id_1a2b3c",
  "name": "Project name",
  "description": "Project description",
  "status": "active",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z"
}

get/projects/{projectId}

Get a project

Returns a single project by ID.

Parameters

projectIdrequired, string

The project ID

Responses

200Successful response

404Project not found

Response

{
  "id": "id_1a2b3c",
  "name": "Project name",
  "description": "Project description",
  "status": "active",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z"
}

delete/projects/{projectId}

Delete a project

Permanently deletes a project and all associated deployments.

Parameters

projectIdrequired, string

The project ID

Responses

204Project deleted

404Project not found

Deployments

get/projects/{projectId}/deployments

List deployments

Returns all deployments for a project.

Parameters

projectIdrequired, string

The project ID

statusoptional, string

Filter by deployment status

Responses

200Successful response

Response

{
  "data": [
    {
      "id": "id_1a2b3c",
      "projectId": "Parent project ID",
      "environment": "staging",
      "status": "pending",
      "tag": "Deployment tag",
      "commitSha": "Git commit SHA",
      "url": "Live URL of the deployment",
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ]
}

post/projects/{projectId}/deployments

Create a deployment

Triggers a new deployment for the project.

Parameters

projectIdrequired, string

The project ID

Request Body

environmentrequired, string

Target environment

Enum: "staging", "production"

tagoptional, string

Deployment tag/label

commitShaoptional, string

Git commit SHA to deploy

Responses

201Deployment created

400Invalid request

Response

{
  "id": "id_1a2b3c",
  "projectId": "Parent project ID",
  "environment": "staging",
  "status": "pending",
  "tag": "Deployment tag",
  "commitSha": "Git commit SHA",
  "url": "Live URL of the deployment",
  "createdAt": "2026-01-15T10:30:00Z"
}

Users

get/users/me

Get current user

Returns the profile of the currently authenticated user.

Responses

200Successful response

401Not authenticated

Response

{
  "id": "id_1a2b3c",
  "name": "Display name",
  "email": "user@example.com",
  "organization": "Organization name",
  "role": "admin",
  "createdAt": "2026-01-15T10:30:00Z"
}

patch/users/me

Update current user

Updates the profile of the currently authenticated user.

Request Body

nameoptional, string

Display name

emailoptional, string

Email address

Responses

200User updated

Response

{
  "id": "id_1a2b3c",
  "name": "Display name",
  "email": "user@example.com",
  "organization": "Organization name",
  "role": "admin",
  "createdAt": "2026-01-15T10:30:00Z"
}