Skip to main content
Version: 1.0.0

Pinboard API

Pinboard API​

Backend API for the Pinboard collaborative workspace application.

Authentication​

All endpoints (except /health and /docs) require JWT authentication. Include the token in the Authorization header:

Authorization: Bearer <your-jwt-token>

Getting Started​

  1. Login via SSO in the frontend (Google, Microsoft, or GitHub)
  2. Exchange session token using POST /api/v1/auth/token/exchange
  3. Use the JWT in the Authorization header for all API calls
  4. Refresh tokens automatically using POST /api/v1/auth/token/refresh

Rate Limiting​

  • Standard endpoints: 100 requests per minute
  • AI/chat endpoints: 10 requests per minute

Error Responses​

All errors follow a consistent format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {...}
  }
}

Common error codes:

  • UNAUTHORIZED (401): Authentication required or token invalid
  • FORBIDDEN (403): Permission denied
  • NOT_FOUND (404): Resource not found
  • BAD_REQUEST (400): Invalid request format
  • VALIDATION_ERROR (422): Request validation failed

Authentication​

Enter your JWT access token obtained from /api/v1/auth/token/exchange

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT

Contact

Pinboard Team:

Last updated on