Projects & Sources

Group related submissions into projects, give them nicknames, pin favorites, and archive older work. All endpoints below require authentication and act on resources owned by your API key.

Projects

List projects

Returns all projects owned by the authenticated API key.

Query Parameters

Example Request

curl -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  https://api.thrixel.com/api/v1/projects

Example Response

{
  "projects": [
    {
      "id": "p1q2r3s4-...",
      "name": "Gargoyle variations",
      "description": "Stylistic experiments",
      "is_archived": false,
      "created_at": "2026-04-18T09:00:00Z",
      "updated_at": "2026-04-20T14:00:00Z",
      "submission_count": 7
    }
  ],
  "count": 1
}

Create a project

Request Body

Example Request

curl -X POST https://api.thrixel.com/api/v1/projects \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Gargoyle variations"}'

Get a project

Returns project metadata plus an embedded list of its submissions (soft-deleted excluded).

Path Parameters

Update a project

Rename or re-describe. At least one field required.

Path Parameters

Request Body

Delete a project

Permanently deletes the project. Submissions in the project are unlinked (project_id set to null) — they are not deleted.

Path Parameters

Project Sources

Each project can carry up to 256 KB of plain-text reference material split across files (max 64 KB per file). Allowed extensions: .md, .markdown, .txt, .text. When you submit a new generation inside the project, the parsed text of every source file is injected into the LLM's system prompt — so this is where you put your style guide, glossary of in-world names, dimensions you want respected ("chairs are always 45 cm tall"), or any other context the model should treat as constant.

List source files

Path Parameters

Example Response

{
  "project_id": "p1q2r3s4-...",
  "sources": [
    {
      "id": "src-9a8b...",
      "project_id": "p1q2r3s4-...",
      "filename": "style.md",
      "mime_type": "text/markdown",
      "size_bytes": 1842,
      "created_at": "2026-04-20T14:00:00Z"
    }
  ],
  "count": 1,
  "total_bytes": 1842
}

total_bytes is the sum across the whole project — useful for checking how much of the 256 KB budget is left before uploading more.

Get a single source

Returns the metadata plus the parsed text of the file (what actually gets injected into the prompt — line endings normalized, content decoded UTF-8).

Path Parameters

Upload a source file

The file is parsed at upload time and stored in the database; the raw upload is also mirrored to S3. The parsed content is injected into the system prompt for every new submission created in the project.

Path Parameters

Form Fields

Example Request

curl -X POST https://api.thrixel.com/api/v1/projects/$PROJECT_ID/sources \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -F "file=@style.md"

Errors

Update a source file

Rename or rewrite the file's content. At least one of filename / content must be present. Per-file and per-project caps still apply.

Request Body

Delete a source file

Removes the DB row and the S3 mirror. Submissions already created in the project are unaffected; only new submissions after this point will see the reduced source set in the system prompt.

Submission Management

Set or clear the nickname

Path Parameters

Request Body

Archive or unarchive

Path Parameters

Request Body

Toggle visibility

Hides or shows the submission in list endpoints without deleting it.

Path Parameters

Request Body

Pin or unpin

Pinned submissions sort to the top of lists.

Path Parameters

Request Body

Assign to a project

Move the submission into a project, or pass null to remove. Both the submission and the target project must belong to your API key.

Path Parameters

Request Body

Soft-delete a submission

Hides the submission from listings but preserves its data. Include soft-deleted items in /submissions via include_deleted=true.

Path Parameters