API Reference

The Remyx REST API is available at https://engine.remyx.ai/api/v1.0. All endpoints require a Bearer token in the Authorization header.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://engine.remyx.ai/api/v1.0/interests

Get your API key at Account > API Access in the Remyx app, or at engine.remyx.ai/account.

Experiments

Manage experiments, track outcomes, and log decisions.

List Experiments

GET /api/v1.0/experiments

Parameter	Type	Description
`initiative`	string	Filter by initiative name
`status`	string	Filter by status
`project_id`	string	Filter by project UUID
`ticket_source`	string	Filter by ticket source (e.g., `linear`, `jira`)
`external_ticket_id`	string	Filter by external ticket ID
`created_via`	string	Filter by creation method (e.g., `mcp`, `web`, `seed`)
`limit`	integer	Max results to return

Response: Array of experiment objects with all ExperimentOps fields.

Get Experiment

GET /api/v1.0/experiments/<experiment_id>

Response: Single experiment object with full detail including source_type, source_ref, hypothesis, target_metric, observed_delta, delta_confidence, decision, tags, initiative, launch_context, ab_test_config, ab_test_results, and linked resources.

Update Experiment

PUT /api/v1.0/experiments/<experiment_id>

Field	Type	Description
`name`	string	Experiment name
`status`	string	`configure`, `in_progress`, `complete`, `validated`
`hypothesis`	string	Hypothesis text
`outcome`	string	`ship`, `iterate`, `abandon`
`decision`	string	Decision text with reasoning
`observed_delta`	float	Measured metric change
`delta_confidence`	string	`significant`, `inconclusive`, `not_tested`
`target_metric`	string	Target business metric
`tags`	array	Free-form tags for grouping
`initiative`	string	Initiative/project name
`pr_url`	string	Link to implementation PR
`pr_status`	string	PR status
`external_ticket_id`	string	Linked external ticket ID
`ticket_source`	string	Ticket provider
`ticket_url`	string	Ticket URL

Implementation

Manage the experiment implementation pipeline — context assembly, implementation runs, and status tracking.

Get Experiment Context

GET /api/v1.0/implement/experiments/<experiment_id>/context

Returns the full experiment context formatted for Claude Code: resource metadata, Docker environment, task description, and implementation plan.

Get Reference Implementation

GET /api/v1.0/implement/experiments/<experiment_id>/reference

Returns reference implementation sources: GitHub repo, Docker image, key methods, and implementation plan extracted from the launch context.

List Actionable Experiments

GET /api/v1.0/implement/experiments/actionable

Parameter	Type	Description
`initiative`	string	Filter by initiative
`limit`	integer	Max results

Returns experiments that have a launch_context but no PR yet — ready for implementation.

Run Implementation

POST /api/v1.0/implement/experiments/<experiment_id>/run

Triggers the server-side implementation pipeline. Returns 202 Accepted with a task reference.

Get Implementation Status

GET /api/v1.0/implement/experiments/<experiment_id>/status

Returns the current pipeline status: pipeline_status, pr_url, pr_status, and timing information.

Report Implementation Result

POST /api/v1.0/implement/experiments/<experiment_id>/report

Field	Type	Description
`pr_url`	string	URL of the created PR
`branch_name`	string	Git branch name
`summary`	string	Implementation summary
`status`	string	Result status
`artifacts`	object	Additional artifact references

Research Interests

Manage your Research Interests — the context that drives personalized resource recommendations.

List Interests

GET /api/v1.0/interests

Response: Array of Research Interest objects with name, context, daily_count, is_active.

Create Interest

POST /api/v1.0/interests

Field	Type	Required	Description
`name`	string	Yes	Interest label (e.g., “Retrieval-Augmented Generation”)
`context`	string	Yes	URLs and descriptions defining the interest
`daily_count`	integer	No	Recommendations per day (default: 3)
`is_active`	boolean	No	Whether the interest is active (default: true)

Get Interest

GET /api/v1.0/interests/<interest_id>

Update Interest

PUT /api/v1.0/interests/<interest_id>

Accepts same fields as Create. Updating context invalidates the recommendation pool and triggers re-ranking.

Delete Interest

DELETE /api/v1.0/interests/<interest_id>

Deletes the interest and cascading recommendations.

Toggle Interest

POST /api/v1.0/interests/<interest_id>/toggle

Toggles the is_active status without deleting the interest or its history.

Recommendations

Get personalized resource recommendations based on your Research Interests.

List Recommendations

GET /api/v1.0/papers/recommended

Parameter	Type	Description
`interest_id`	string	Filter by interest UUID
`limit`	integer	Max results
`period`	string	`today`, `week`

Response: Array of recommended resources with titles, abstracts, relevance scores, and links.

Get Digest

GET /api/v1.0/papers/recommended/digest

Parameter	Type	Description
`limit`	integer	Max results per interest
`period`	string	`today`, `week`

Response: Structured digest grouped by Research Interest.

Refresh Recommendations

POST /api/v1.0/papers/recommended/refresh

Field	Type	Description
`interest_id`	string	Refresh a specific interest (optional — refreshes all if omitted)
`num_results`	integer	Number of results to generate

Returns 202 Accepted with a task reference for polling.

Poll Refresh Status

GET /api/v1.0/papers/recommended/refresh/<task_id>

Returns the status of an async recommendation refresh task.

Search

Search across research assets with hybrid retrieval.

Search Assets

POST /api/v1.0/search/assets

Field	Type	Description
`query`	string	Natural language search query
`max_results`	integer	Max results to return
`has_docker`	boolean	Filter for resources with runnable Docker environments
`categories`	array	Filter by categories
`use_llm`	boolean	Enable LLM-enhanced search

Response: Array of matching assets with titles, abstracts, categories, Docker availability, and relevance scores.

Get Asset Details

GET /api/v1.0/search/assets/<arxiv_id>

Returns detailed information for a specific asset: full abstract, Docker status, Dockerfile, reference summary.

List Recent Assets

GET /api/v1.0/search/assets/list

Parameter	Type	Description
`limit`	integer	Max results (default: 20)
`offset`	integer	Pagination offset
`category`	string	Filter by category
`has_docker`	boolean	Filter for Docker availability

Get Asset Statistics

GET /api/v1.0/search/stats

Returns aggregate statistics: total assets, counts by Docker availability, by category, and citation classification coverage.

Integrations

Manage OAuth connections to external tools (GitHub, Linear, Jira).

List Providers

GET /api/v1.0/integrations/providers

Returns available integration providers with configuration status.

Get OAuth URL

GET /api/v1.0/integrations/<provider_name>/auth-url

Returns the OAuth authorization URL to initiate the connection flow.

Exchange OAuth Code

POST /api/v1.0/integrations/<provider_name>/callback

Field	Type	Description
`code`	string	OAuth authorization code
`redirect_uri`	string	Callback URI used in the auth flow

List Connections

GET /api/v1.0/integrations/connections

Returns all active integration connections for the current user.

Check Connection Status

GET /api/v1.0/integrations/<provider_name>/status

Disconnect Provider

DELETE /api/v1.0/integrations/<provider_name>

Deactivates the integration connection for the specified provider.

Get OAuth Token

GET /api/v1.0/integrations/<provider_name>/token

Returns a valid OAuth token for the specified provider. Auto-refreshes expired tokens before returning. Accepts optional user_id query param for service tokens.

Identity Resolution

GET /api/v1.0/integrations/identity/resolve

Parameter	Type	Description
`source`	string	External platform (e.g., `github`, `linear`)
`external_id`	string	External user ID
`external_email`	string	External user email (alternative to external_id)

POST /api/v1.0/integrations/identity/link

Creates an identity link between a Remyx user and an external platform identity.

GET /api/v1.0/integrations/identity/links

Lists all identity links for the current user.

Authentication

All API requests require a JWT token passed as a Bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://engine.remyx.ai/api/v1.0/experiments

API keys are available at Account > API Access in the Remyx Studio.

Response Codes

Code	Meaning
`200`	Success
`201`	Created
`202`	Accepted (async task started)
`400`	Bad request (invalid parameters)
`401`	Unauthorized (missing or invalid token)
`403`	Forbidden (insufficient permissions)
`404`	Not found
`409`	Conflict (e.g., duplicate resource)
`500`	Server error

API Documentation

​API Reference

​Experiments

​List Experiments

​Get Experiment

​Update Experiment

​Implementation

​Get Experiment Context

​Get Reference Implementation

​List Actionable Experiments

​Run Implementation

​Get Implementation Status

​Report Implementation Result

​Research Interests

​List Interests

​Create Interest

​Get Interest

​Update Interest

​Delete Interest

​Toggle Interest

​Recommendations

​List Recommendations

​Get Digest

​Refresh Recommendations

​Poll Refresh Status

​Search

​Search Assets

​Get Asset Details

​List Recent Assets

​Get Asset Statistics

​Integrations

​List Providers

​Get OAuth URL

​Exchange OAuth Code

​List Connections

​Check Connection Status

​Disconnect Provider

​Get OAuth Token

​Identity Resolution

​Authentication

​Response Codes

API Reference

Experiments

List Experiments

Get Experiment

Update Experiment

Implementation

Get Experiment Context

Get Reference Implementation

List Actionable Experiments

Run Implementation

Get Implementation Status

Report Implementation Result

Research Interests

List Interests

Create Interest

Get Interest

Update Interest

Delete Interest

Toggle Interest

Recommendations

List Recommendations

Get Digest

Refresh Recommendations

Poll Refresh Status

Search

Search Assets

Get Asset Details

List Recent Assets

Get Asset Statistics

Integrations

List Providers

Get OAuth URL

Exchange OAuth Code

List Connections

Check Connection Status

Disconnect Provider

Get OAuth Token

Identity Resolution

Authentication

Response Codes