List All

GET

/artifacts

GET

/api/v1/artifacts

curl -G https://api.taktoria.com/api/v1/artifacts \
     -H "Authorization: Bearer <token>" \
     -d quarter=3 \
     -d type=LEARNINGS \
     -d year=2026

{
  "data": [
    {
      "createdAt": "2026-07-01T12:00:00Z",
      "exports": [
        {
          "tool": "NOTION",
          "url": "https://app.notion.com/p/3f1c9d2b8a7e4c0f9d1a2b3c4d5e6f70",
          "title": "Smart Email: Learnings",
          "exportedAt": "2026-09-30T12:00:00Z",
          "location": "Launch reviews",
          "exportedBy": {
            "id": "usr_ada",
            "name": "Ada Lovelace"
          }
        }
      ],
      "id": "art_5c2d",
      "launch": {
        "id": "lch_7f3a",
        "name": "Smart Email",
        "status": "LAUNCHED"
      },
      "launchId": "lch_7f3a",
      "type": "LEARNINGS",
      "updatedAt": "2026-09-30T12:00:00Z",
      "content": "## What worked\n\nShipping the EU copy a week early."
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Every launch’s artifacts, as the Artifacts page shows them across launches: by their launch’s planned launch date (drafts without one first), then by type, each with its launch. Gather a quarter’s learnings, say, with type=LEARNINGS&period=2026-Q3. A launch has its artifacts once its steps are added or they are created (POST /launches/{launchId}/artifacts); one with none is not listed. Needs artifacts:read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

typeenumOptional

Only this kind; left out, all three.

Allowed values:

periodstringOptional

A fiscal period, as the app’s period picker and its URL name them: a quarter (2026-Q4), a whole year (2027), upcoming for this quarter and every one after it, or all. Repeat it for several (period=2026-Q4&period=2027-Q1); upcoming or all among them wins over the rest. Narrows by the launch’s planned launch date in the workspace’s fiscal years. With upcoming it keeps those with no date yet, as the app’s lists do. Left out, with no year, every period. Wins over year and quarter; anything else is a 422 validation_error.

yearintegerOptional

One fiscal year, as the workspace’s fiscal year start names it. Narrows by the launch’s planned launch date; left out, every year. period takes several.

quarterintegerOptional

A fiscal quarter, 1 to 4, of year. Needs year; left out, the whole year.

limitintegerOptional

cursorstringOptional

Response

This endpoint returns an object.

datalist of objects

hasMoreboolean

nextCursorstringOptional

Pass as cursor for the next page; null on the last.

Errors

401

Unauthorized Error

402

Subscription Required Error

422

Validation Error

429

Too Many Requests Error