Delete a project

DELETE

/v1/projects/{project_id}

curl --request DELETE \
  --url https://api.hydrate.sh/v1/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

• Production

Permanently delete a project you own, along with its branches, graph and stored artifacts. This cannot be undone.

Requires the project:delete scope, which is separate from graph:write and is not implied by it — a key that can author a graph cannot erase one unless it was minted with this scope as well. Keys issued before this scope existed do not have it and must be re-minted.

Only the project’s owner may delete it. A caller who can see the project but does not own it gets the same 404 a non-existent project gets, so the response never reveals whether a project exists.

Authorizations

• Bearer

Parameters

Path Parameters

project_id

required

Project Id

The project to delete.

string format: uuid

The project to delete.

Responses

204

Successful Response

401

No credentials, malformed credentials, or revoked credentials. The envelope is leak-parity (same shape across all 401 paths) so an attacker cannot distinguish revoked vs. unknown via the body.

Media typeapplication/json

object

detail

required

string

Example

{
  "detail": "unauthenticated"
}

403

Credentials are valid but lack the scope required for this route, or the principal lacks membership in the target project.

Media typeapplication/json

object

detail

object

code

string

message

string

Example^generated

{
  "detail": {
    "code": "example",
    "message": "example"
  }
}

404

Resource not found OR not accessible to this principal. Leak parity: the response is identical in both cases so an attacker cannot enumerate resources via 404-vs-403 timing.

Media typeapplication/json

object

detail

object

code

string

message

string

Example

{
  "detail": {
    "code": "not_found"
  }
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}

429

Per-bucket rate limit exceeded. The response carries Retry-After and the standard X-RateLimit-* headers (Limit / Remaining / Reset).

Media typeapplication/json

object

detail

string

Example

{
  "detail": "rate_limited"
}

Headers

Retry-After

integer

X-RateLimit-Limit

integer

X-RateLimit-Remaining

integer

X-RateLimit-Reset

integer