API

Developer resources and API reference for ORKA integration.

ORKA provides a REST API for developers who want to integrate with the platform programmatically.

Authentication

All API requests require an API key. Generate one from your workspace settings.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.orka.app/v1/projects

Endpoints

Projects

# List all projects
GET /v1/projects

# Get a specific project
GET /v1/projects/:id

# Create a project
POST /v1/projects

Milestones

# List milestones for a project
GET /v1/projects/:id/milestones

# Update milestone status
PATCH /v1/milestones/:id

Payments

# List payments
GET /v1/projects/:id/payments

# Get payment details
GET /v1/payments/:id
Info

The API is rate-limited to 1000 requests per minute per API key.

Webhooks

Subscribe to events to get notified when things happen:

  • project.created
  • milestone.submitted
  • milestone.approved
  • payment.released
{
  "event": "payment.released",
  "data": {
    "projectId": "proj_123",
    "milestoneId": "ms_456",
    "amount": 5000,
    "currency": "USD"
  }
}

SDKs

Official SDKs are available for:

  • JavaScript/TypeScript: npm install @orka/sdk
  • Python: pip install orka-sdk
  • Go: go get github.com/orka/sdk-go

Was this page helpful?

Your feedback helps us improve.