API referenceBoard

Board

14 operations. Every schema and example on this page is generated from the platform contract.

GET/api/v1/board/activity

Recent board-wide activity feed (board_activity), newest first, capped.

auth operator:boardop listBoardActivityrate limited errors

Parameters

limitintegerqueryoptional

How many recent events to return (default 100, max 200).

Response, 200

activityarray of objectrequired

6 child fields

idnumberrequired

ticket_idstringrequired

actorstringrequired

verbstringrequired

detailstring, nullablerequired

created_atstringrequired

curl -G "https://www.membber.com/api/v1/board/activity" \
  -H "Authorization: Bearer $MEMBBER_TOKEN"

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.GET("/api/v1/board/activity");

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.listBoardActivity().ok.body.json

print(response)

Response, 200

{
  "activity": [
    {
      "id": 1,
      "ticket_id": "fbc29b2e-0000-4000-8000-d0c5000000fb",
      "actor": "<actor>",
      "verb": "<verb>",
      "detail": "<detail>",
      "created_at": "<created_at>"
    }
  ]
}

GET/api/v1/board/candidates

The pick-next ranking: eligible unclaimed Todo items a thread could take.

auth operator:boardop getBoardCandidatesrate limited errors

Parameters

limitintegerqueryoptional

How many candidates to return (default 12, max 50).

Response, 200

candidatesarray of objectrequired

14 child fields

idstringrequired

titlestring, nullablerequired

typestringrequired

sectionstring, nullablerequired

epic_idstring, nullablerequired

priostringrequired

founder_ordnumber, nullablerequired

founder_rankedbooleanrequired

tierstringrequired

'founder-binding' when the founder has ranked it, else 'judgement'.

unblocks_countnumberrequired

age_daysnumber, nullablerequired

adjacent_to_inflightbooleanrequired

branchstring, nullablerequired

pr_numbernumber, nullablerequired

curl -G "https://www.membber.com/api/v1/board/candidates" \
  -H "Authorization: Bearer $MEMBBER_TOKEN"

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.GET("/api/v1/board/candidates");

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.getBoardCandidates().ok.body.json

print(response)

Response, 200

{
  "candidates": [
    {
      "id": "00000d1b-0000-4000-8000-d0c500000000",
      "title": "Morning class",
      "type": "<type>",
      "section": "<section>",
      "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
      "prio": "<prio>",
      "founder_ord": 1,
      "founder_ranked": true,
      "tier": "<tier>",
      "unblocks_count": 1,
      "age_days": 1,
      "adjacent_to_inflight": true,
      "branch": "<branch>",
      "pr_number": 1
    }
  ]
}

POST/api/v1/board/claim

Atomically claim a candidate ticket (409 if the race was lost / it is ineligible).

auth operator:boardop claimBoardTicketidempotent retry rate limited errors

Request body

idstringrequired

The ticket to claim.

sessionstringrequired

The claiming thread/session id (stamped on the row).

assigneestringrequired

Who is picking it up.

Response, 200

ticketobjectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

curl -X POST "https://www.membber.com/api/v1/board/claim" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "session": "<session>",
    "assignee": "<assignee>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/claim", {
  body: {
    id: "00000d1b-0000-4000-8000-d0c500000000",
    session: "<session>",
    assignee: "<assignee>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.claimBoardTicket(
    body: .json(.init(
        id: "00000d1b-0000-4000-8000-d0c500000000",
        session: "<session>",
        assignee: "<assignee>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "ticket": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "source": "<source>",
    "pr_number": 1,
    "branch": "<branch>",
    "section": "<section>",
    "col": "<col>",
    "founder_col": "<founder_col>",
    "pr_state": "<pr_state>",
    "type": "<type>",
    "prio": "<prio>",
    "title": "Morning class",
    "raw_title": "<raw_title>",
    "summary": "<summary>",
    "why": "<why>",
    "what_it_does": "<what_it_does>",
    "user_story": "<user_story>",
    "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
    "when_ts": "<when_ts>",
    "content_source": "<content_source>",
    "synced_at": "<synced_at>",
    "assignee": "<assignee>",
    "claimed_at": "<claimed_at>",
    "session_id": "630ddf64-0000-4000-8000-d0c500000063",
    "depends_on": [
      "<depends_on>"
    ],
    "labels": [
      "<label>"
    ],
    "notes": "Added at the front desk",
    "founder_ord": 1
  }
}

GET/api/v1/board/inbox

The operator inbox: questions/decisions/updates surfaced by any thread, untriaged first then newest first.

auth operator:boardop listBoardInboxrate limited errors

Response, 200

inboxarray of objectrequired

9 child fields

idstringrequired

titlestringrequired

bodystringrequired

section_hintstring, nullablerequired

priority_hintstring, nullablerequired

reopen_ofstring, nullablerequired

The ticket id this inbox item re-opens, or null for a fresh item.

statusstringrequired

'untriaged' or 'triaged'.

created_atstringrequired

triaged_atstring, nullablerequired

curl -G "https://www.membber.com/api/v1/board/inbox" \
  -H "Authorization: Bearer $MEMBBER_TOKEN"

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.GET("/api/v1/board/inbox");

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.listBoardInbox().ok.body.json

print(response)

Response, 200

{
  "inbox": [
    {
      "id": "00000d1b-0000-4000-8000-d0c500000000",
      "title": "Morning class",
      "body": "<body>",
      "section_hint": "<section_hint>",
      "priority_hint": "<priority_hint>",
      "reopen_of": "<reopen_of>",
      "status": "<status>",
      "created_at": "<created_at>",
      "triaged_at": "<triaged_at>"
    }
  ]
}

POST/api/v1/board/inbox/{id}/triage

Triage an inbox item: assign section + priority and mark it triaged.

auth operator:boardop triageBoardInboxidempotent retry rate limited errors

Parameters

idstringpathrequired

Request body

sectionstringrequired

The section to file this inbox item under.

prioritystringrequired

The priority to assign to this inbox item.

Response, 200

inbox_itemobjectrequired

9 child fields

idstringrequired

titlestringrequired

bodystringrequired

section_hintstring, nullablerequired

priority_hintstring, nullablerequired

reopen_ofstring, nullablerequired

The ticket id this inbox item re-opens, or null for a fresh item.

statusstringrequired

'untriaged' or 'triaged'.

created_atstringrequired

triaged_atstring, nullablerequired

curl -X POST "https://www.membber.com/api/v1/board/inbox/00000d1b-0000-4000-8000-d0c500000000/triage" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "section": "<section>",
    "priority": "<priority>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/inbox/{id}/triage", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
  body: {
    section: "<section>",
    priority: "<priority>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.triageBoardInbox(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000"),
    body: .json(.init(
        section: "<section>",
        priority: "<priority>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "inbox_item": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "title": "Morning class",
    "body": "<body>",
    "section_hint": "<section_hint>",
    "priority_hint": "<priority_hint>",
    "reopen_of": "<reopen_of>",
    "status": "<status>",
    "created_at": "<created_at>",
    "triaged_at": "<triaged_at>"
  }
}

POST/api/v1/board/session

Sign in to the Membber HQ board with email + password.

Verifies the email/password against Supabase auth, then checks the founder allowlist. On success mints a short-lived operator token. A correct password for a non-allow-listed address is a refusal (403), not a login.

auth none, publicop boardLoginidempotent retry rate limited errors

Request body

emailstringrequired

The operator email (verified against Supabase auth).

passwordstringrequired

The account password, verified against Supabase, never stored here.

Response, 200

tokenstringrequired

The operator bearer token to send as Authorization: Bearer on every board call.

mestringrequired

The verified, allow-listed operator email.

expiresAtstringrequired

ISO timestamp the token expires.

curl -X POST "https://www.membber.com/api/v1/board/session" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alex@example.com",
    "password": "<password>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/session", {
  body: {
    email: "alex@example.com",
    password: "<password>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.boardLogin(
    body: .json(.init(
        email: "alex@example.com",
        password: "<password>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "token": "<token>",
  "me": "<me>",
  "expiresAt": "<expiresAt>"
}

POST/api/v1/board/session/apple

Sign in to the Membber HQ board with Sign in with Apple.

Verifies the Apple identity token fully (RS256 signature against Apple's JWKS, issuer, audience com.membber.hq, expiry), then checks the founder allowlist on the verified email. A missing / relay / non-allow-listed email is a 403 that echoes the email + Apple subject it saw, so the founder can add it. On success mints the same operator token.

auth none, publicop boardLoginAppleidempotent retry rate limited errors

Request body

identityTokenstringrequired

The Sign in with Apple identity token (JWT) returned to the app.

Response, 200

tokenstringrequired

The operator bearer token to send as Authorization: Bearer on every board call.

mestringrequired

The verified, allow-listed operator email.

expiresAtstringrequired

ISO timestamp the token expires.

curl -X POST "https://www.membber.com/api/v1/board/session/apple" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "identityToken": "<identityToken>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/session/apple", {
  body: {
    identityToken: "<identityToken>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.boardLoginApple(
    body: .json(.init(
        identityToken: "<identityToken>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "token": "<token>",
  "me": "<me>",
  "expiresAt": "<expiresAt>"
}

POST/api/v1/board/session/google

Sign in to the Membber HQ board with Google.

Verifies the Google ID token fully (RS256 signature against Google's JWKS via jwks-rsa, issuer accounts.google.com, audience the Membber Google client id, expiry) using the SAME production verifier the App Clip customer Google sign-in uses, src/lib/auth/googleAuth.ts verifyGoogleIdToken. Then checks the founder allowlist on the verified email. A missing / unverified / non-allow-listed email is a 403 that echoes the email + Google subject it saw, so the founder can add it. On success mints the same operator token.

auth none, publicop boardLoginGoogleidempotent retry rate limited errors

Request body

credentialstringrequired

The Google ID token (JWT) returned to the app.

Response, 200

tokenstringrequired

The operator bearer token to send as Authorization: Bearer on every board call.

mestringrequired

The verified, allow-listed operator email.

expiresAtstringrequired

ISO timestamp the token expires.

curl -X POST "https://www.membber.com/api/v1/board/session/google" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "credential": "<credential>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/session/google", {
  body: {
    credential: "<credential>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.boardLoginGoogle(
    body: .json(.init(
        credential: "<credential>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "token": "<token>",
  "me": "<me>",
  "expiresAt": "<expiresAt>"
}

GET/api/v1/board/tickets

List board tickets (filterable + keyset-paginated), founder overlay resolved.

auth operator:boardop listBoardTicketsrate limited errors

Parameters

colstringqueryoptional

Filter to a resolved column (e.g. todo, doing, review, done, blocked).

typestringqueryoptional

Filter to a resolved type (bug, feature, task).

sectionstringqueryoptional

Filter to a section (payments, verticals, business, customer, platform).

qstringqueryoptional

Free-text match against title, raw title, why, id, branch and assignee.

limitintegerqueryoptional

Page size (default 50, max 200).

cursorstringqueryoptional

Opaque keyset cursor from a previous page.

Response, 200

ticketsarray of objectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

next_cursorstring, nullablerequired

Cursor for the next page, or null when the list is exhausted.

curl -G "https://www.membber.com/api/v1/board/tickets" \
  -H "Authorization: Bearer $MEMBBER_TOKEN"

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.GET("/api/v1/board/tickets");

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.listBoardTickets().ok.body.json

print(response)

Response, 200

{
  "tickets": [
    {
      "id": "00000d1b-0000-4000-8000-d0c500000000",
      "source": "<source>",
      "pr_number": 1,
      "branch": "<branch>",
      "section": "<section>",
      "col": "<col>",
      "founder_col": "<founder_col>",
      "pr_state": "<pr_state>",
      "type": "<type>",
      "prio": "<prio>",
      "title": "Morning class",
      "raw_title": "<raw_title>",
      "summary": "<summary>",
      "why": "<why>",
      "what_it_does": "<what_it_does>",
      "user_story": "<user_story>",
      "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
      "when_ts": "<when_ts>",
      "content_source": "<content_source>",
      "synced_at": "<synced_at>",
      "assignee": "<assignee>",
      "claimed_at": "<claimed_at>",
      "session_id": "630ddf64-0000-4000-8000-d0c500000063",
      "depends_on": [
        "<depends_on>"
      ],
      "labels": [
        "<label>"
      ],
      "notes": "Added at the front desk",
      "founder_ord": 1
    }
  ],
  "next_cursor": "<next_cursor>"
}

GET/api/v1/board/tickets/{id}

Get one board ticket with its comments and activity.

auth operator:boardop getBoardTicketrate limited errors

Parameters

idstringpathrequired

Response, 200

ticketobjectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

commentsarray of objectrequired

6 child fields

idstringrequired

ticket_idstringrequired

authorstringrequired

bodystringrequired

mediaarray of objectrequired

Pre-denormalised media stored on the comment (may be empty).

created_atstringrequired

activityarray of objectrequired

6 child fields

idnumberrequired

ticket_idstringrequired

actorstringrequired

verbstringrequired

detailstring, nullablerequired

created_atstringrequired

curl -G "https://www.membber.com/api/v1/board/tickets/00000d1b-0000-4000-8000-d0c500000000" \
  -H "Authorization: Bearer $MEMBBER_TOKEN"

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.GET("/api/v1/board/tickets/{id}", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.getBoardTicket(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000")
).ok.body.json

print(response)

Response, 200

{
  "ticket": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "source": "<source>",
    "pr_number": 1,
    "branch": "<branch>",
    "section": "<section>",
    "col": "<col>",
    "founder_col": "<founder_col>",
    "pr_state": "<pr_state>",
    "type": "<type>",
    "prio": "<prio>",
    "title": "Morning class",
    "raw_title": "<raw_title>",
    "summary": "<summary>",
    "why": "<why>",
    "what_it_does": "<what_it_does>",
    "user_story": "<user_story>",
    "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
    "when_ts": "<when_ts>",
    "content_source": "<content_source>",
    "synced_at": "<synced_at>",
    "assignee": "<assignee>",
    "claimed_at": "<claimed_at>",
    "session_id": "630ddf64-0000-4000-8000-d0c500000063",
    "depends_on": [
      "<depends_on>"
    ],
    "labels": [
      "<label>"
    ],
    "notes": "Added at the front desk",
    "founder_ord": 1
  },
  "comments": [
    {
      "id": "00000d1b-0000-4000-8000-d0c500000000",
      "ticket_id": "fbc29b2e-0000-4000-8000-d0c5000000fb",
      "author": "<author>",
      "body": "<body>",
      "media": [
        {}
      ],
      "created_at": "<created_at>"
    }
  ],
  "activity": [
    {
      "id": 1,
      "ticket_id": "fbc29b2e-0000-4000-8000-d0c5000000fb",
      "actor": "<actor>",
      "verb": "<verb>",
      "detail": "<detail>",
      "created_at": "<created_at>"
    }
  ]
}

PATCH/api/v1/board/tickets/{id}

Edit a ticket via the founder overlay (title, notes, type, priority, epic, labels).

auth operator:boardop editBoardTicketidempotent retry rate limited errors

Parameters

idstringpathrequired

Request body

overlayobjectrequired

Partial overlay patch: a key PRESENT sets it (null clears the override), a key ABSENT is left untouched.

6 child fields

display_titlestring, nullableoptional

Founder title override; null clears it.

notesstring, nullableoptional

type_overridestring, nullableoptional

prio_overridestring, nullableoptional

epic_idstring, nullableoptional

labelsarray of stringoptional

Full label set; null or omitted leaves it untouched.

Response, 200

ticketobjectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

curl -X PATCH "https://www.membber.com/api/v1/board/tickets/00000d1b-0000-4000-8000-d0c500000000" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "overlay": {
      "display_title": "<display_title>",
      "notes": "Added at the front desk",
      "type_override": "<type_override>",
      "prio_override": "<prio_override>",
      "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
      "labels": [
        "<label>"
      ]
    }
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.PATCH("/api/v1/board/tickets/{id}", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
  body: {
    overlay: {
      display_title: "<display_title>",
      notes: "Added at the front desk",
      type_override: "<type_override>",
      prio_override: "<prio_override>",
      epic_id: "a3ea3c95-0000-4000-8000-d0c5000000a3",
      labels: [
        "<label>"
      ]
    }
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.editBoardTicket(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000"),
    body: .json(.init(
        overlay: .init(
            displayTitle: "<display_title>",
            notes: "Added at the front desk",
            typeOverride: "<type_override>",
            prioOverride: "<prio_override>",
            epicId: "a3ea3c95-0000-4000-8000-d0c5000000a3",
            labels: ["<label>"]
        )
    ))
).ok.body.json

print(response)

Response, 200

{
  "ticket": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "source": "<source>",
    "pr_number": 1,
    "branch": "<branch>",
    "section": "<section>",
    "col": "<col>",
    "founder_col": "<founder_col>",
    "pr_state": "<pr_state>",
    "type": "<type>",
    "prio": "<prio>",
    "title": "Morning class",
    "raw_title": "<raw_title>",
    "summary": "<summary>",
    "why": "<why>",
    "what_it_does": "<what_it_does>",
    "user_story": "<user_story>",
    "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
    "when_ts": "<when_ts>",
    "content_source": "<content_source>",
    "synced_at": "<synced_at>",
    "assignee": "<assignee>",
    "claimed_at": "<claimed_at>",
    "session_id": "630ddf64-0000-4000-8000-d0c500000063",
    "depends_on": [
      "<depends_on>"
    ],
    "labels": [
      "<label>"
    ],
    "notes": "Added at the front desk",
    "founder_ord": 1
  }
}

POST/api/v1/board/tickets/{id}/assign

Assign or unassign a ticket.

auth operator:boardop assignBoardTicketidempotent retry rate limited errors

Parameters

idstringpathrequired

Request body

assigneestring, nullablerequired

Who owns it now; null unassigns.

Response, 200

ticketobjectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

curl -X POST "https://www.membber.com/api/v1/board/tickets/00000d1b-0000-4000-8000-d0c500000000/assign" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "assignee": "<assignee>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/tickets/{id}/assign", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
  body: {
    assignee: "<assignee>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.assignBoardTicket(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000"),
    body: .json(.init(
        assignee: "<assignee>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "ticket": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "source": "<source>",
    "pr_number": 1,
    "branch": "<branch>",
    "section": "<section>",
    "col": "<col>",
    "founder_col": "<founder_col>",
    "pr_state": "<pr_state>",
    "type": "<type>",
    "prio": "<prio>",
    "title": "Morning class",
    "raw_title": "<raw_title>",
    "summary": "<summary>",
    "why": "<why>",
    "what_it_does": "<what_it_does>",
    "user_story": "<user_story>",
    "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
    "when_ts": "<when_ts>",
    "content_source": "<content_source>",
    "synced_at": "<synced_at>",
    "assignee": "<assignee>",
    "claimed_at": "<claimed_at>",
    "session_id": "630ddf64-0000-4000-8000-d0c500000063",
    "depends_on": [
      "<depends_on>"
    ],
    "labels": [
      "<label>"
    ],
    "notes": "Added at the front desk",
    "founder_ord": 1
  }
}

POST/api/v1/board/tickets/{id}/comments

Add a comment to a ticket.

auth operator:boardop commentBoardTicketidempotent retry rate limited errors

Parameters

idstringpathrequired

Request body

bodystringrequired

The comment text (non-empty).

mediaarray of objectoptional

Optional pre-uploaded media descriptors to denormalise onto the comment.

client_message_idstringoptional

Client-generated idempotency key (same pattern as the messaging architecture's client_message_id). A retry with the same key on the same ticket is a no-op that returns the ORIGINAL comment, never a duplicate, this route is declared idempotency:{mode:"rpc"}, which board_comment now actually enforces.

Response, 200

commentobjectrequired

6 child fields

idstringrequired

ticket_idstringrequired

authorstringrequired

bodystringrequired

mediaarray of objectrequired

Pre-denormalised media stored on the comment (may be empty).

created_atstringrequired

curl -X POST "https://www.membber.com/api/v1/board/tickets/00000d1b-0000-4000-8000-d0c500000000/comments" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "<body>"
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/tickets/{id}/comments", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
  body: {
    body: "<body>"
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.commentBoardTicket(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000"),
    body: .json(.init(
        body: "<body>"
    ))
).ok.body.json

print(response)

Response, 200

{
  "comment": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "ticket_id": "fbc29b2e-0000-4000-8000-d0c5000000fb",
    "author": "<author>",
    "body": "<body>",
    "media": [
      {}
    ],
    "created_at": "<created_at>"
  }
}

POST/api/v1/board/tickets/{id}/move

Move / reposition a ticket into To-do or Blocked (founder overlay).

auth operator:boardop moveBoardTicketidempotent retry rate limited errors

Parameters

idstringpathrequired

Request body

colenumrequired

The founder can only move an item to To-do or Blocked; threads advance the rest.

todoblocked

ordnumberrequired

Fractional sort index within the target column.

Response, 200

ticketobjectrequired

27 child fields

idstringrequired

sourcestringrequired

pr_numbernumber, nullablerequired

branchstring, nullablerequired

sectionstring, nullablerequired

colstring, nullablerequired

Resolved column: the founder override (founder_col) if set, else the synced col.

founder_colstring, nullablerequired

The founder column override, or null when the item is not founder-pinned.

pr_statestring, nullablerequired

typestringrequired

Resolved type: type_override if set, else the synced type.

priostringrequired

Resolved priority: prio_override if set, else the synced prio.

titlestring, nullablerequired

Resolved title: display_title ?? title ?? raw_title.

raw_titlestring, nullablerequired

summarystring, nullablerequired

whystring, nullablerequired

what_it_doesstring, nullablerequired

user_storystring, nullablerequired

epic_idstring, nullablerequired

when_tsstring, nullablerequired

ISO date (YYYY-MM-DD) the work landed / was raised.

content_sourcestring, nullablerequired

synced_atstringrequired

ISO timestamp of the last sync write.

assigneestring, nullablerequired

claimed_atstring, nullablerequired

session_idstring, nullablerequired

depends_onarray of stringrequired

labelsarray of stringrequired

notesstring, nullablerequired

founder_ordnumber, nullablerequired

curl -X POST "https://www.membber.com/api/v1/board/tickets/00000d1b-0000-4000-8000-d0c500000000/move" \
  -H "Authorization: Bearer $MEMBBER_TOKEN" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "col": "todo",
    "ord": 1
  }'

import { createMembberClient } from "@membber/sdk-ts";

const membber = createMembberClient({
  getAccessToken: () => process.env.MEMBBER_TOKEN,
});

const { data, error } = await membber.raw.POST("/api/v1/board/tickets/{id}/move", {
  params: { path: { id: "00000d1b-0000-4000-8000-d0c500000000" } },
  body: {
    col: "todo",
    ord: 1
  },
  headers: { "Idempotency-Key": crypto.randomUUID() },
});

if (error) {
  // Typed error envelope: { error: { code, message, requestId } }
  throw new Error(`${error.error.code}: ${error.error.message}`);
}
console.log(data);

import MembberSwift

let client = MembberClient(
    serverURL: MembberClient.productionServerURL,
    tokenProvider: { session.accessToken }
)

let response = try await client.api.moveBoardTicket(
    path: .init(id: "00000d1b-0000-4000-8000-d0c500000000"),
    body: .json(.init(
        col: .todo,
        ord: 1
    ))
).ok.body.json

print(response)

Response, 200

{
  "ticket": {
    "id": "00000d1b-0000-4000-8000-d0c500000000",
    "source": "<source>",
    "pr_number": 1,
    "branch": "<branch>",
    "section": "<section>",
    "col": "<col>",
    "founder_col": "<founder_col>",
    "pr_state": "<pr_state>",
    "type": "<type>",
    "prio": "<prio>",
    "title": "Morning class",
    "raw_title": "<raw_title>",
    "summary": "<summary>",
    "why": "<why>",
    "what_it_does": "<what_it_does>",
    "user_story": "<user_story>",
    "epic_id": "a3ea3c95-0000-4000-8000-d0c5000000a3",
    "when_ts": "<when_ts>",
    "content_source": "<content_source>",
    "synced_at": "<synced_at>",
    "assignee": "<assignee>",
    "claimed_at": "<claimed_at>",
    "session_id": "630ddf64-0000-4000-8000-d0c500000063",
    "depends_on": [
      "<depends_on>"
    ],
    "labels": [
      "<label>"
    ],
    "notes": "Added at the front desk",
    "founder_ord": 1
  }
}