Authentication

Every request needs a Bearer token. Generate one from your account settings. Tokens are scoped to your organisation and revocable.

Authorization: Bearer YOUR_TOKEN
Accept: application/json
Content-Type: application/json

Quick start

List your projects in four lines of code. Pick the sample that matches your stack.

curl

curl https://sprintflint.com/api/v1/projects \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Ruby

require 'net/http'
require 'json'

uri = URI('https://sprintflint.com/api/v1/projects')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer YOUR_TOKEN'
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts JSON.parse(res.body)

Python

import requests

r = requests.get(
    'https://sprintflint.com/api/v1/projects',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
print(r.json())

Node

const res = await fetch('https://sprintflint.com/api/v1/projects', {
  headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
const data = await res.json();
console.log(data);

Resource model

Four core resources, with consistent CRUD semantics across all of them.

For AI coding agents

SprintFlint is designed to be readable by AI agents. Two surfaces are public.

Rate limits and conventions

• Base URL: https://sprintflint.com/api/v1
• Auth: Authorization: Bearer YOUR_TOKEN
• Format: JSON request and response. Content-Type: application/json on writes.
• Errors: Standard HTTP status codes. Body is { "error": "human-readable message" } on 4xx/5xx.
• Pagination: ?page=N&per_page=M on collection endpoints. per_page defaults to 25, max 100.
• Rate limit: 600 requests / minute / token. 429 on exceed with Retry-After header.