Create and manage SimplyStack projects programmatically with the Projects API.

Projects API

The Projects API allows you to programmatically create and manage your SimplyStack projects. This is useful for automation, CI/CD pipelines, and managing multiple projects at scale.

Authentication

The Projects API requires a personal API key (not project-specific). Get your personal API key from your account settings.

Bash

curl -H "x-api-key: your-personal-api-key" \
     "https://www.simplystack.dev/api/v1/projects"

List Projects

GET /api/v1/projects

Retrieve all projects in your account.

JavaScript

const response = await fetch('https://www.simplystack.dev/api/v1/projects', {
  headers: { 'x-api-key': 'your-personal-api-key' }
});
const { data } = await response.json();
console.log('Projects:', data);

Create Project

POST /api/v1/projects

Create a new SimplyStack project.

JavaScript

const response = await fetch('https://www.simplystack.dev/api/v1/projects', {
  method: 'POST',
  headers: {
    'x-api-key': 'your-personal-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'My New Project',
    description: 'Project description'
  })
});
const { data } = await response.json();
console.log('Created project:', data);

Get Project

GET /api/v1/projects/{id}

Get details for a specific project by ID.

JavaScript

const projectId = 'your-project-id';
const response = await fetch(
  `https://www.simplystack.dev/api/v1/projects/${projectId}`,
  { headers: { 'x-api-key': 'your-personal-api-key' } }
);
const { data } = await response.json();

Update Project

PUT /api/v1/projects/{id}

Update an existing project.

JavaScript

const response = await fetch(
  `https://www.simplystack.dev/api/v1/projects/${projectId}`,
  {
    method: 'PUT',
    headers: {
      'x-api-key': 'your-personal-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Updated Project Name',
      description: 'Updated description'
    })
  }
);

Delete Project

DELETE /api/v1/projects/{id}

Delete a project. This action is irreversible.

JavaScript

const response = await fetch(
  `https://www.simplystack.dev/api/v1/projects/${projectId}`,
  {
    method: 'DELETE',
    headers: { 'x-api-key': 'your-personal-api-key' }
  }
);

Next Steps

Content API - Add content to your projects
Storage API - Upload files to your projects
API Overview - Learn about authentication and best practices