Creator Tasks

List a project's creator tasks

curl "https://api.subscriby.net/v1/projects/$PROJECT_ID/creator-tasks?status=open" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

status is open (the default: tasks not yet done whose grant still stands), completed, or all. Paged like every list but oldest first by default, so the longest-waiting member is at the top.

  • grant_id is the access ledger row the task belongs to; read it with the subscription's grants, where its mode is creator_task.
  • instructions is the sentence the dashboard shows the creator, in the creator's locale.
  • due_at is null for continuous access and the window's start for a dated pass.
  • completed_at and completed_by_user_id are set once the task is done.
get/v1/projects/{project}/creator-tasks

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/creator-tasks
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

Query parameters

status'open' | 'completed' | 'all'

Which creator tasks a list shows. Open is the working list: tasks not yet done whose grant still stands, so a purchase that ended drops out without anyone marking it. Completed is the record; All is both.

The tab: open (the default) lists tasks not yet done whose grant still stands, completed the ones marked done, all both.

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

sort_bystring

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to asc.

Response

The page, oldest first by default.

Example response

{
  "data": [
    {
      "id": "9e4b2c71-3d58-4a6f-b0e2-7c1d5f8a9b34",
      "grant_id": "7d1c3e9a-2b64-4f0e-9a58-3c6b1d8e2f47",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4",
      "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
      "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
      "resource_title": "Welcome packet",
      "instructions": "Give Ada Lovelace access to Welcome packet.",
      "created_at": "2026-09-12T10:05:30Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.