Cyrus365Cyrus365ProjectsDocs
Back to Projects App
Back to Projects App

API Changelog

Version history for the Projects.ink API.

v1.6.0 — August 2026

Role-gated task deletion + soft delete to Bin
  • •DELETE /projects/:id/tasks/:taskId now enforces the project's Task Deletion setting (Owner only / Owner & Admins — default / All members) and returns 403 with error code TASK_DELETE_FORBIDDEN when the API key owner's role is not allowed to delete
  • •Deleted tasks are now soft-deleted to the project Bin — restorable from the web app (Project Settings → Bin) for 30 days — instead of being permanently removed
  • •Roadmap: a dedicated tasks.delete scope is planned for a future release — deletion currently requires tasks.write

v1.3.0 — April 2026

Increased rate limits for all PUBLIC API keys
  • •All plan-based rate limits have been significantly increased with per-minute windows:

- FREE: 60 requests per minute

- PRO / FOUNDER: 300 requests per minute

- ENTERPRISE: 1,200 requests per minute

  • •All rate limit windows are now uniformly 1 minute (previously mixed minute/hour)
  • •If the plan cannot be determined, the FREE limit (60 req/min) applies as default

v1.2.0 — February 2026

Plan-based rate limits for all PUBLIC API keys
  • •User-level and project-level keys now share the same rate limit system
  • •Limits are based on the organization's subscription plan:

- FREE / PRO / FOUNDER: 1 request per minute

- ENTERPRISE: 10 requests per minute

  • •Rate limits are resolved dynamically — upgrading your plan takes effect within 10 minutes without regenerating keys
  • •If the plan cannot be determined, the FREE limit applies as default

v1.1.0 — February 2026

Project-level API keys
  • •New scoped API keys can be created from Project Settings → API tab
  • •Keys are restricted to a single project with limited scopes
  • •Cannot use projects.read, projects.write, or wildcard * scopes
  • •Ideal for CI/CD pipelines, Slack integrations, and single-project automations
  • •Settings-created project keys work as the project owner's identity, so long-running automations keep working even if the creating admin is removed

v1.0.0 — June 2025

Initial V1 API release
  • •Full CRUD for projects, tasks, subtasks, comments
  • •Sprint and group management
  • •Member listing
  • •Tag management (hierarchical)
  • •Calendar event support
  • •Activity log retrieval
  • •Webhook subscriptions with HMAC-SHA256 signature verification
  • •Page-based pagination (max 200 items per page)
  • •Bearer token authentication with scope-based access control

Related

  • •API Overview — Base URL, response format, and error codes
  • •Authentication & Keys — API key types and scopes

Previous

Webhooks