ProjectsUpdate Project

Projects

Update Project

Update project name, icon, or color

Request

projectIdstringpathrequired

The unique identifier of the project

Authorizationstringheaderrequired

Bearer token for authentication

namestringbody

New project name (1-255 characters)

iconstringbody

New project icon. Available options:

  • Code2, Terminal, Bot, Brain, Sparkles
  • Database, GitBranch, Bug, FolderKanban
  • Folder, Files, Library, BookOpen
  • Briefcase, Package, Layers, AppWindow
  • Rocket, Palette, Paintbrush, PenTool
  • Lightbulb, BarChart3, Settings, Globe
colorstringbody

New project color. Available options:

  • rose, pink, orange, amber, emerald
  • cyan, blue, purple, slate, gray

Response

successboolean

Indicates if the request was successful

dataobject

Request Example

curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated Name", "icon": "Rocket", "color": "emerald"}' \
  https://cloud.specstory.com/api/v1/projects/proj_abc123
const response = await fetch('https://cloud.specstory.com/api/v1/projects/proj_abc123', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Updated Name',
    icon: 'Rocket',
    color: 'emerald'
  })
});

const data = await response.json();
import requests

response = requests.patch(
    'https://cloud.specstory.com/api/v1/projects/proj_abc123',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'name': 'Updated Name',
        'icon': 'Rocket',
        'color': 'emerald'
    }
)

data = response.json()

Response Example

{
  "success": true,
  "data": {
    "name": "Updated Name",
    "icon": "Rocket",
    "color": "emerald"
  }
}
{
  "success": false,
  "error": "You do not have permission to update this project"
}
{
  "success": false,
  "error": "Project not found"
}