# Illumina Lab

## Docs

- [Delete feedback](https://docs.illuminalab.com/api-reference/feedback/delete-feedback.md): Permanently delete a feedback entry by ID.
- [Get feedback statistics](https://docs.illuminalab.com/api-reference/feedback/get-feedback-statistics.md): Get aggregated feedback statistics (count of ups and downs) for a thread.
- [List feedback by thread](https://docs.illuminalab.com/api-reference/feedback/list-feedback-by-thread.md): Get all feedback for a thread. Returns feedback ordered by creation time.
- [Upsert feedback](https://docs.illuminalab.com/api-reference/feedback/upsert-feedback.md): Create or update feedback for a message or thread. For message feedback, provide message_id and use sentiment values of -1 (down) or 1 (up). For thread feedback, omit message_id and use sentiment values from 0 to 5.
- [Create resource](https://docs.illuminalab.com/api-reference/resources/create-resource.md): Create a new resource with a client-provided ID and optional metadata. The ID must be at least 10 characters and cannot contain whitespace. Metadata is a free-form JSON object.
- [Delete resource](https://docs.illuminalab.com/api-reference/resources/delete-resource.md): Permanently delete a resource and all its associated threads (via database CASCADE). This action cannot be undone.
- [Delete thread](https://docs.illuminalab.com/api-reference/resources/delete-thread.md): Soft-delete a thread. The thread is marked as deleted but not permanently removed from the database. Use include_deleted=true on other endpoints to access deleted threads.
- [Get resource](https://docs.illuminalab.com/api-reference/resources/get-resource.md): Get a single resource by ID. Returns the full resource object including metadata and working_memory.
- [Get thread messages](https://docs.illuminalab.com/api-reference/resources/get-thread-messages.md): Get all messages for a thread. Returns all message parts without filtering, including reasoning and internal tool calls. Use /public-messages for filtered output.
- [Get thread public messages](https://docs.illuminalab.com/api-reference/resources/get-thread-public-messages.md): Get all messages for a thread with filtered parts. Removes reasoning and internal tool parts for safe display to end users.
- [List resources](https://docs.illuminalab.com/api-reference/resources/list-resources.md): Get all resources for the authenticated team. Resources represent distinct entities (e.g., users, teams, etc) that can have associated conversation threads.
- [List threads for resource](https://docs.illuminalab.com/api-reference/resources/list-threads-for-resource.md): Get paginated threads for a resource. Use sanitize=true (default) to remove sensitive fields like team_id and working_memory. Use include_deleted=true to include soft-deleted threads.
- [Update resource metadata](https://docs.illuminalab.com/api-reference/resources/update-resource-metadata.md): Update resource metadata by merging the provided fields with existing metadata. Existing fields not included in the request body are preserved. To remove a field, set it to null.
- [Get thread](https://docs.illuminalab.com/api-reference/threads/get-thread.md): Get a thread by ID. Returns the full thread object including metadata.
- [Get thread messages](https://docs.illuminalab.com/api-reference/threads/get-thread-messages.md): Get messages for a thread. Returns paginated results by default. Use `all=true` to fetch all messages at once (ignores limit/offset).
- [List threads](https://docs.illuminalab.com/api-reference/threads/list-threads.md): Get all threads for the authenticated team. Returns paginated results sorted by creation date.
- [Execute workflow](https://docs.illuminalab.com/api-reference/workflow/execute-workflow.md): Execute a named workflow with the provided message and stream SSE events back. Returns a Server-Sent Events stream following the AI SDK UI Message protocol. The stream includes assistant messages, tool calls, and tool results.

## OpenAPI Specs

- [openapi](https://docs.illuminalab.com/openapi.json)