API Reference

Complete API documentation for integrating Astra AI into your applications

API Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer your-api-key-here

Authentication

POST/api/auth/google

Authenticate with Google OAuth

Parameters:

codestate

Response:

user object with token

POST/api/auth/username

Authenticate with username/password

Parameters:

usernamepassword

Response:

user object with token

POST/api/auth/logout

Logout current user

Parameters:

token

Response:

success message

AI Generation

POST/api/ai/generate

Generate code from natural language

Parameters:

promptlanguageframework

Response:

generated code and files

POST/api/ai/enhance

Enhance prompt for better results

Parameters:

prompt

Response:

enhanced prompt

POST/api/ai/chat

Chat with AI for code refinement

Parameters:

messagecontext

Response:

AI response

Workspace

GET/api/workspace

Get all user workspaces

Parameters:

userIdtoken

Response:

array of workspace objects

POST/api/workspace/create

Create new workspace

Parameters:

titledescriptionuserId

Response:

workspace object

PUT/api/workspace/:id

Update workspace

Parameters:

workspaceIdupdates

Response:

updated workspace

DELETE/api/workspace/:id

Delete workspace

Parameters:

workspaceId

Response:

success message

Files & Assets

GET/api/files/:workspaceId

Get all files in workspace

Parameters:

workspaceId

Response:

array of file objects

POST/api/files/upload

Upload file to workspace

Parameters:

fileworkspaceIdpath

Response:

file object

DELETE/api/files/:fileId

Delete file

Parameters:

fileId

Response:

success message

Rate Limits

Free Plan

• 100 requests per hour
• 10 AI generations per day
• Community support

Pro Plan

• 1000 requests per hour
• 100 AI generations per day
• Priority support

Official SDKs

JavaScript / TypeScript

npm install @astra-ai/sdk

Python

pip install astra-ai

cURL / REST

Direct HTTP requests