feat: create pixel

.github/workflows/verify.yml

@@ -31,4 +31,4 @@ jobs:
         run: ./gradlew detekt
 
       - name: Check tests
-        run: ./gradlew allTests -Pkover koverVerify
+        run: ./gradlew jvmTest -Pkover koverVerify

AGENTS.md

@@ -37,6 +37,7 @@ Dokka and Maven publish require `--no-configuration-cache` despite it being glob
 - General mocking: Mokkery.
 - Test names use backtick style: `` fun `should do something`() = runTest { ... } ``
 - Tests live in `commonTest` only — no platform-specific test source sets.
+- **Sample data**: use fixtures (see the `fixtures` skill in `.agents/skills/fixtures/`) instead of inline object literals whenever a test needs a domain model. A fixture is an extension on a model's `Companion` (e.g. `Pixel.fixture()`) living in `commonTest` under the model's own package. When a requested fixture references other domain models, the skill creates those in cascade and reuses any existing fixture rather than duplicating. See `umami-api/src/commonTest/.../domain/PixelFixture.kt` and `PixelsTest.kt` for the canonical pattern.
 - See `umami-api/src/commonTest/AGENTS.md` for detailed test-writing patterns (MockEngine helpers, `getUmamiInstance`, `respond<T>`, `body<T>()`).
 
 Key difference between the two `getUmamiInstance` copies: `:umami-api` sets `enableEventQueue = false`; `:umami` leaves it enabled.

docs/pixels.md

@@ -24,6 +24,24 @@ This method returns the details of a specific pixel.
 val pixel = api.pixels().getPixel("pixel-id")
 ```
 
+## Create a pixel
+
+This method creates a new tracking pixel.
+
+```kotlin
+val pixel = api.pixels().createPixel(
+    name = "New Pixel",
+    slug = "new-pixel-slug",
+    teamId = "team-id"
+)
+```
+
+### Parameters
+
+- `name` (required): The name for the pixel.
+- `slug` (required): The slug for the pixel.
+- `teamId` (optional): The ID of the team to associate the pixel with.
+
 ## Update a pixel
 
 This method updates the details of a specific pixel.

docs/roadmap.md

@@ -114,7 +114,7 @@ These endpoints are only available for admin users on self-hosted instances.
 ## Pixels
 
 - [x] Returns all user pixels - `GET /api/pixels`
-- [ ] Creates a new pixel - `POST /api/pixels`
+- [x] Creates a new pixel - `POST /api/pixels`
 - [x] Gets a pixel by ID - `GET /api/pixels/:pixelId`
 - [x] Updates a pixel - `POST /api/pixels/:pixelId`
 - [x] Deletes a pixel - `DELETE /api/pixels/:pixelId`

mkdocs.yml

@@ -40,7 +40,6 @@ nav:
     - Teams: teams.md
     - Users: users.md
   - Roadmap: roadmap.md
-  - Release notes: release-notes.md
   - API Reference: reference
 
 markdown_extensions:

umami-api/src/commonMain/kotlin/dev/appoutlet/umami/api/Pixels.kt

@@ -47,6 +47,30 @@ class Pixels(private val api: UmamiApi) {
         return api.httpClient.get("pixels/$pixelId").body()
     }
 
+    /**
+     * Creates a new tracking pixel.
+     *
+     * @param name The name for the pixel.
+     * @param slug The slug for the pixel.
+     * @param teamId The ID of the team to associate the pixel with. Optional.
+     * @return The created [Pixel] object.
+     */
+    suspend fun createPixel(
+        name: String,
+        slug: String,
+        teamId: String? = null,
+    ): Pixel {
+        val request = CreatePixelRequest(
+            name = name,
+            slug = slug,
+            teamId = teamId,
+        )
+
+        return api.httpClient.post("pixels") {
+            setBody(request)
+        }.body()
+    }
+
     /**
      * Updates an existing pixel.
      *
@@ -79,7 +103,14 @@ class Pixels(private val api: UmamiApi) {
     }
 
     @Serializable
-    private data class UpdatePixelRequest(
+    internal data class CreatePixelRequest(
+        val name: String,
+        val slug: String,
+        val teamId: String? = null,
+    )
+
+    @Serializable
+    internal data class UpdatePixelRequest(
         val name: String? = null,
         val slug: String? = null
     )

umami-api/src/commonTest/kotlin/dev/appoutlet/umami/api/PixelsTest.kt

@@ -2,32 +2,22 @@ package dev.appoutlet.umami.api
 
 import dev.appoutlet.umami.domain.Pixel
 import dev.appoutlet.umami.domain.SearchResponse
+import dev.appoutlet.umami.domain.fixture
 import dev.appoutlet.umami.testing.getUmamiApiInstance
 import dev.appoutlet.umami.testing.respond
 import io.kotest.matchers.shouldBe
 import io.ktor.http.content.OutgoingContent
 import kotlinx.coroutines.test.runTest
-import kotlinx.serialization.Serializable
 import kotlinx.serialization.json.Json
 import kotlin.test.Test
-import kotlin.time.Instant
 
 class PixelsTest {
     @Test
     fun `getPixels returns search response`() = runTest {
-        val mockPixel = Pixel(
-            id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-            name = "Umami Pixel",
-            slug = "xxxxxxxx",
-            userId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-            teamId = null,
-            createdAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            updatedAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            deletedAt = null
-        )
+        val fixturePixel = Pixel.fixture()
 
         val mockResponse = SearchResponse(
-            data = listOf(mockPixel),
+            data = listOf(fixturePixel),
             count = 1,
             page = 1,
             pageSize = 10
@@ -69,26 +59,73 @@ class PixelsTest {
     @Test
     fun `getPixel returns pixel`() = runTest {
         val pixelId = "pixel-id"
-        val mockPixel = Pixel(
-            id = pixelId,
-            name = "Umami Pixel",
-            slug = "xxxxxxxx",
-            userId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-            teamId = null,
-            createdAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            updatedAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            deletedAt = null
-        )
+
+        val fixturePixel = Pixel.fixture()
 
         val api = getUmamiApiInstance(
             "/api/pixels/$pixelId" to { request ->
                 request.url.encodedPath shouldBe "/api/pixels/$pixelId"
-                respond(mockPixel)
+
+                respond(fixturePixel)
             }
         )
 
         val response = api.pixels().getPixel(pixelId)
-        response shouldBe mockPixel
+
+        response shouldBe fixturePixel
+    }
+
+    @Test
+    fun `createPixel creates pixel`() = runTest {
+        val requestName = "Umami Pixel"
+        val requestSlug = "pixel-slug"
+        val requestTeamId = "team-id"
+
+        val fixturePixel = Pixel.fixture()
+
+        val api = getUmamiApiInstance(
+            "/api/pixels" to { request ->
+                request.url.encodedPath shouldBe "/api/pixels"
+                val bodyText = (request.body as OutgoingContent.ByteArrayContent).bytes().decodeToString()
+                val createRequest = Json.decodeFromString<Pixels.CreatePixelRequest>(bodyText)
+                createRequest.name shouldBe requestName
+                createRequest.slug shouldBe requestSlug
+                createRequest.teamId shouldBe requestTeamId
+                respond(fixturePixel)
+            }
+        )
+
+        val response = api.pixels().createPixel(
+            name = requestName,
+            slug = requestSlug,
+            teamId = requestTeamId,
+        )
+
+        response shouldBe fixturePixel
+    }
+
+    @Test
+    fun `createPixel sends null teamId by default`() = runTest {
+        val fixturePixel = Pixel.fixture()
+
+        val api = getUmamiApiInstance(
+            "/api/pixels" to { request ->
+                request.url.encodedPath shouldBe "/api/pixels"
+                val bodyText = (request.body as OutgoingContent.ByteArrayContent).bytes().decodeToString()
+                val createRequest = Json.decodeFromString<Pixels.CreatePixelRequest>(bodyText)
+                createRequest.name shouldBe "Umami Pixel"
+                createRequest.slug shouldBe "pixel-slug"
+                createRequest.teamId shouldBe null
+                respond(fixturePixel)
+            }
+        )
+
+        val response = api.pixels().createPixel(
+            name = "Umami Pixel",
+            slug = "pixel-slug",
+        )
+
+        response shouldBe fixturePixel
     }
 
     @Test
@@ -97,32 +134,16 @@ class PixelsTest {
         val requestName = "Umami Pixel Updated"
         val requestSlug = "updated-slug"
 
-        val mockPixel = Pixel(
-            id = pixelId,
-            name = requestName,
-            slug = requestSlug,
-            userId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
-            teamId = null,
-            createdAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            updatedAt = Instant.parse("2025-10-27T18:50:54.079Z"),
-            deletedAt = null
-        )
+        val fixturePixel = Pixel.fixture()
 
         val api = getUmamiApiInstance(
             "/api/pixels/$pixelId" to { request ->
                 request.url.encodedPath shouldBe "/api/pixels/$pixelId"
                 val bodyText = (request.body as OutgoingContent.ByteArrayContent).bytes().decodeToString()
-
-                @Serializable
-                data class UpdatePixelRequest(
-                    val name: String? = null,
-                    val slug: String? = null
-                )
-
-                val updateRequest = Json.decodeFromString<UpdatePixelRequest>(bodyText)
+                val updateRequest = Json.decodeFromString<Pixels.UpdatePixelRequest>(bodyText)
                 updateRequest.name shouldBe requestName
                 updateRequest.slug shouldBe requestSlug
-                respond(mockPixel)
+                respond(fixturePixel)
             }
         )
 
@@ -131,7 +152,8 @@ class PixelsTest {
             name = requestName,
             slug = requestSlug
         )
-        response shouldBe mockPixel
+
+        response shouldBe fixturePixel
     }
 
     @Test