Skip to main content
D
Dits
Documentation

Dits REST API

Programmatic access to Dits repositories, users, and metadata through a comprehensive REST API.

API Overview

The Dits REST API provides full programmatic access to repository management, user administration, and metadata operations. Built for integrations with CI/CD, project management tools, and custom workflows.

100+
API Endpoints
REST
Architecture
JSON
Data Format

Authentication

Bearer Tokens
For session-based authentication
Authorization: Bearer <session_token>
Content-Type: application/json

# Token expires after 24 hours
# Obtained via POST /auth/login

Use for interactive applications and short-lived sessions.

API Tokens
For programmatic access
Authorization: Bearer dits_<api_token>
Content-Type: application/json

# Scoped permissions available
# Created in user settings

Use for CI/CD, integrations, and long-running processes.

Authentication Endpoints

MethodEndpointDescription
POST/auth/loginLogin with username/password
POST/auth/refreshRefresh session token
POST/auth/logoutInvalidate session

Rate Limits & Best Practices

Rate Limits
Authenticated requests
5,000/hour
Unauthenticated requests
60/hour
Search requests
30/minute
Best Practices
  • Use API tokens for CI/CD
  • Implement exponential backoff for retries
  • Cache responses when possible
  • Use webhooks for real-time updates
  • Batch operations when available