curl -H "Authorization: Bearer octra_YOUR_API_KEY" https://octra.env.pm/v1/chat/completions

curl -X POST https://octra.env.pm/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"api_key": "octra_YOUR_API_KEY", "model": "...", "messages": [...]}'

curl -X POST https://octra.env.pm/auth/email/request-code \
  -H "Content-Type: application/json" \
  -d '{"purpose": "login", "email": "me@example.com"}'

curl -X POST https://octra.env.pm/auth/email/verify-code \
  -H "Content-Type: application/json" \
  -d '{"purpose": "login", "email": "me@example.com", "code": "123456"}'

curl -X POST https://octra.env.pm/v1/chat/completions \
  -H "Authorization: Bearer octra_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

curl -N -X POST https://octra.env.pm/v1/chat/completions \
  -H "Authorization: Bearer octra_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

curl -X POST https://octra.env.pm/api/openai/environments/chat/completions \
  -H "Authorization: Bearer octra_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "workflow/octra/YOUR_ENV_ID",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl -X POST https://octra.env.pm/api/openai/environments/chat/completions \
  -H "Authorization: Bearer octra_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 900 \
  -d '{
    "model": "workflow/octra/YOUR_ENV_ID",
    "messages": [{"role": "user", "content": "Summarise the README."}]
  }'

# 1. Queue the work
curl -X POST https://octra.env.pm/v1/chat/completions \
  -H "Authorization: Bearer octra_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "workflow/octra/YOUR_ENV_ID",
    "messages": [{"role": "user", "content": "Refactor the auth module."}],
    "runtime": true
  }'
# -> {"status_code": "sc_1a2b3c", "session": "..."}

# 2. Poll it
curl https://octra.env.pm/api/chat/environments/YOUR_ENV_ID/status/sc_1a2b3c/check/chat \
  -H "Authorization: Bearer octra_YOUR_API_KEY"

service ChatService {
  rpc Chat(stream ChatRequest) returns (stream ChatResponse);
  rpc SubmitChat(ChatSubmitRequest) returns (ChatSubmitResponse);
  rpc GetChatStatus(ChatStatusRequest) returns (ChatStatusResponse);
}

message ChatRequest { string prompt = 1; }
message ChatResponse {
  oneof payload { string token = 1; string error = 2; }
  bool done = 3;
}

grpcurl -plaintext \
  -H "x-api-key: octra_YOUR_API_KEY" \
  -H "x-environment-id: YOUR_ENV_ID" \
  -d '{"prompt": "Hello, agent!"}' \
  YOUR_HOST:9090 chat.ChatService/Chat

type Mutation {
  chat(environmentId: String!, prompt: String!, apiKey: String!): String
  submitChat(environmentId: String!, prompt: String!, apiKey: String!): ChatSubmitResult
}

type Query {
  ping: String
  chatStatus(environmentId: String!, statusCode: String!, apiKey: String!): ChatStatusResult
}

curl -X POST https://octra.env.pm/graphql \
  -H "Content-Type: application/json" \
  -d '{"query": "mutation { chat(environmentId: \"YOUR_ENV_ID\", prompt: \"Hello!\", apiKey: \"octra_YOUR_API_KEY\") }"}'

const socket = new WebSocket(
  'wss://octra.env.pm/ws/chat/YOUR_ENV_ID?token=octra_YOUR_API_KEY',
);

socket.onopen = () => socket.send(JSON.stringify({ prompt: 'Hello, agent!' }));
socket.onmessage = (event) => {
  const frame = JSON.parse(event.data);
  if (frame.type === 'token') process.stdout.write(frame.token);
  if (frame.type === 'error') console.error(frame.error);
  if (frame.type === 'done') socket.close();
};

// Error response format
{
  "error": {
    "message": "Environment not found",
    "type": "not_found_error",
    "code": 404
  }
}