name: sprintflint-api
description: Manage SprintFlint projects, sprints, issues, and comments via REST API. Use when you need to create tickets, update status, or track sprint progress.

SprintFlint API Skill

Interact with SprintFlint sprint ticketing platform through the REST API. Use this skill to manage projects, sprints, issues/tickets, and comments.

When to Use

Use this skill when you need to:

• List, create, or update projects
• List, create, update, or manage sprints
• List, create, update, or delete issues/tickets
• Add comments to issues
• Track sprint progress and velocity

Authentication

All requests require the X-API-Token header. Use the SPRINTFLINT_API_TOKEN environment variable:

curl -H "X-API-Token: $SPRINTFLINT_API_TOKEN" https://sprintflint.com/api/v1/projects

Important: The user must have SPRINTFLINT_API_TOKEN set in their environment. If it's not set, ask them to:

1. Go to SprintFlint → Profile → API Token
2. Generate a token
3. Add export SPRINTFLINT_API_TOKEN="token" to their shell profile

Base URL

All endpoints use: https://sprintflint.com/api/v1

API Reference

Projects

List all projects:

GET /api/v1/projects

Get a project:

GET /api/v1/projects/{id}

Create a project:

POST /api/v1/projects
Content-Type: application/json

{
  "project": {
    "name": "My Project",
    "prefix": "MP",
    "description": "Optional description"
  }
}

Update a project:

PATCH /api/v1/projects/{id}
Content-Type: application/json

{
  "project": {
    "name": "Updated Name"
  }
}

Delete a project: (admin only)

DELETE /api/v1/projects/{id}

Sprints

List sprints in a project:

GET /api/v1/projects/{project_id}/sprints

Get a sprint:

GET /api/v1/projects/{project_id}/sprints/{id}

Create a sprint:

POST /api/v1/projects/{project_id}/sprints
Content-Type: application/json

{
  "sprint": {
    "name": "Sprint 1",
    "start_date": "2026-02-01",
    "end_date": "2026-02-14",
    "description": "Optional description"
  }
}

Update a sprint:

PATCH /api/v1/projects/{project_id}/sprints/{id}
Content-Type: application/json

{
  "sprint": {
    "name": "Updated Sprint Name"
  }
}

Activate a sprint:

POST /api/v1/projects/{project_id}/sprints/{id}/activate

Complete a sprint:

POST /api/v1/projects/{project_id}/sprints/{id}/complete

Delete a sprint: (admin only)

DELETE /api/v1/projects/{project_id}/sprints/{id}

Issues (Tickets)

List issues in a sprint:

GET /api/v1/projects/{project_id}/sprints/{sprint_id}/issues

Get an issue:

GET /api/v1/projects/{project_id}/sprints/{sprint_id}/issues/{id}

Create an issue:

POST /api/v1/projects/{project_id}/sprints/{sprint_id}/issues
Content-Type: application/json

{
  "issue": {
    "title": "Implement feature X",
    "description": "Detailed description",
    "status": "backlog",
    "story_points": 3,
    "assignee_id": 123
  }
}

Valid statuses: backlog, todo, in_progress, done, cancelled

Update an issue:

PATCH /api/v1/projects/{project_id}/sprints/{sprint_id}/issues/{id}
Content-Type: application/json

{
  "issue": {
    "status": "in_progress",
    "story_points": 5
  }
}

Delete an issue:

DELETE /api/v1/projects/{project_id}/sprints/{sprint_id}/issues/{id}

Comments

List comments on an issue:

GET /api/v1/projects/{project_id}/sprints/{sprint_id}/issues/{issue_id}/comments

Get a comment:

GET /api/v1/comments/{id}

Create a comment:

POST /api/v1/projects/{project_id}/sprints/{sprint_id}/issues/{issue_id}/comments
Content-Type: application/json

{
  "comment": {
    "body": "This is my comment"
  }
}

Update a comment: (author only)

PATCH /api/v1/comments/{id}
Content-Type: application/json

{
  "comment": {
    "body": "Updated comment text"
  }
}

Delete a comment: (author only)

DELETE /api/v1/comments/{id}

Response Schemas

Project

{
  "id": 1,
  "name": "SprintFlint",
  "prefix": "SF-",
  "description": "Sprint ticketing platform",
  "sprints_count": 5,
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-15T00:00:00Z"
}

Sprint

{
  "id": 1,
  "name": "Sprint 1",
  "slug": "sprint-1",
  "status": "active",
  "start_date": "2026-01-19",
  "end_date": "2026-01-23",
  "issues_count": 7,
  "total_story_points": 21,
  "completed_story_points": 8,
  "project_id": 1,
  "created_at": "2026-01-19T00:00:00Z",
  "updated_at": "2026-01-20T00:00:00Z"
}

Issue

{
  "id": 1,
  "title": "Implement feature X",
  "description": "Detailed description",
  "status": "in_progress",
  "story_points": 3,
  "position": 1,
  "issue_number": "SF-1",
  "sprint_id": 1,
  "assignee_id": 123,
  "started_at": "2026-01-20T10:00:00Z",
  "completed_at": null,
  "created_at": "2026-01-19T00:00:00Z",
  "updated_at": "2026-01-20T00:00:00Z"
}

Comment

{
  "id": 1,
  "body": "This is my comment",
  "issue_id": 1,
  "author_id": 123,
  "author_name": "John Doe",
  "created_at": "2026-01-20T00:00:00Z",
  "updated_at": "2026-01-20T00:00:00Z"
}

Error Handling

401 Unauthorized - Invalid or missing API token

{ "error": "Unauthorized" }

403 Forbidden - Not authorized for this action

{ "error": "Forbidden" }

404 Not Found - Resource not found

{ "error": "Not found" }

422 Unprocessable Entity - Validation errors

{ "errors": ["Title can't be blank", "Name is too short"] }

Examples

Create a complete workflow

# 1. Create a project
curl -X POST https://sprintflint.com/api/v1/projects \
  -H "X-API-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project": {"name": "New Project", "prefix": "NP"}}'

# 2. Create a sprint
curl -X POST https://sprintflint.com/api/v1/projects/1/sprints \
  -H "X-API-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sprint": {"name": "Sprint 1", "start_date": "2026-02-01", "end_date": "2026-02-14"}}'

# 3. Create issues
curl -X POST https://sprintflint.com/api/v1/projects/1/sprints/1/issues \
  -H "X-API-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"issue": {"title": "Setup project", "story_points": 2}}'

# 4. Activate the sprint
curl -X POST https://sprintflint.com/api/v1/projects/1/sprints/1/activate \
  -H "X-API-Token: $TOKEN"

# 5. Update issue status
curl -X PATCH https://sprintflint.com/api/v1/projects/1/sprints/1/issues/1 \
  -H "X-API-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"issue": {"status": "done"}}'