Skip to content

Add new project management endpoints and error codes#465

Open
hey-august wants to merge 3 commits into
mainfrom
august-20260710-new-project-mgmt-endpoints
Open

Add new project management endpoints and error codes#465
hey-august wants to merge 3 commits into
mainfrom
august-20260710-new-project-mgmt-endpoints

Conversation

@hey-august

Copy link
Copy Markdown
Collaborator

Description

Adds API reference documentation for the new project management endpoints under /api/projects.

Until now, listing, showing, and updating projects (and creating subprojects) was only possible through the LaML Accounts API. These native endpoints add scoped project management to the SignalWire REST API.

Notably, only subprojects can be created and deleted using these endpoints. Projects themselves are still managed only in the Dashboard.

The path for these new endpoints is /api/projects (plural), not to be confused for the existing /api/project (singular) token endpoints. This is intentional. The singular path is a "current project" endpoint — it takes no ID and acts only on the authenticated project, so it cannot address a specific subproject. The plural projects path is a standard REST collection that takes an {id}, making it much more useful for project management.

The spec is authored in TypeSpec under specs/signalwire-rest/projects-api/. The three new error codes (nested_subprojects_not_allowed, only_subprojects_can_be_deleted, phone_numbers_must_be_removed) are also added to the REST error codes doc.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update
  • Code cleanup / refactor

Related Issues

signalwire/cloud-product#19427

Testing

  • Added/updated unit tests
  • Tested manually
  • Tested with live SignalWire credentials (if applicable)

Checklist

  • I have read the CONTRIBUTING guidelines
  • My code follows the project's style guidelines
  • I have added tests for my changes (if applicable)
  • I have updated documentation (if applicable)
  • All existing tests pass

@github-actions

github-actions Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

niravcodes
niravcodes previously approved these changes Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants