API & Models

Database models

The persisted models the engine installs.

• RcrewAI::Rails::Crew — Crew configurations
• RcrewAI::Rails::Agent — Agent definitions
• RcrewAI::Rails::Task — Task definitions
• RcrewAI::Rails::Execution — Execution history (batch runs share a batch_id)
• RcrewAI::Rails::ExecutionLog — Detailed execution logs
• RcrewAI::Rails::KnowledgeSource — Knowledge (RAG) sources, owned by an agent or a crew
• RcrewAI::Rails::FlowState — Persisted rcrewai Flow state (resume flows across restarts)
• RcrewAI::Rails::FlowRun — Flow-run tracking (status, inputs, result, timing)

JSON API endpoints

Served under /rcrewai/api/v1/.

Method	Path
GET	/crews
GET	/crews/:id
POST	/crews
POST	/crews/:id/execute
GET	/executions
GET	/executions/:id
GET	/executions/:id/status
GET	/executions/:id/logs

Running executions

Executions run through ActiveJob by default.

crew.execute_async(inputs)   # enqueue (default)
crew.execute_sync(inputs)    # run inline

# Custom job options:
RcrewAI::Rails::CrewExecutionJob.set(wait: 5.minutes).perform_later(crew, inputs)