SelfManager API

GET/v1/me

Your SelfManager account.

Whose key this is: display name, plan, today's date and the timezone used, what the key may do, and the Integration Credits its requests spend. When requests use them, it also says how many are left.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/me"

Answer

• display_name string, optional
• plan "Individual", "Team", "Trial", "Team credits", optional
• today string, optional Today's date in your timezone, as YYYY-MM-DD. Absent when the timezone isn't known.
• timezone string, optional The IANA timezone in use. Absent when none is known.
• timezone_note string, optional
• scopes list of "read", "write", "shared", "delete", "journal", "media", "docs", "webhooks" What this connection may do.
• connection "assistant", "personal_api_key"
• ai_credits_left integer, optional Only while requests use AI credits, which the API's no longer do: see integration_credits_left.
• ai_credits_note string, optional
• credits object, optional Your AI credits, which SelfManager's AI features and AI assistants spend; the API's requests spend Integration Credits. Absent when they can't be read, or there are none to spend.
  • weekly_left integer This week's AI credits left.
  • weekly_allowance integer The plan's AI credits each week.
  • used_this_week integer Weekly AI credits used this week.
  • purchased integer Bought AI credits left. They never expire.
  • total integer All AI credits left: weekly, then purchased.
  • renews_on string The Monday (UTC) the weekly AI credits renew, as YYYY-MM-DD.
  • pool "yours", "team_owner" Your own credits, or a Team owner's you spend.
• integration_credits_left integer, optional Only while requests use Integration Credits.
• integration_credits_note string, optional
• integration_credits object, optional The credits the API's requests spend. Absent when they can't be read, or there are none to spend.
  • weekly_left integer This week's Integration Credits left.
  • weekly_allowance integer The plan's Integration Credits each week.
  • used_this_week integer Weekly Integration Credits used this week.
  • purchased integer Bought Integration Credits left. They never expire.
  • total integer All Integration Credits left: weekly, then purchased.
  • renews_on string The Monday (UTC) the weekly Integration Credits renew, as YYYY-MM-DD.
  • pool "yours", "team_owner" Your own credits, or a Team owner's you spend.
• storage object, optional Your docs storage. What you add to someone else's table counts on its owner, not here. Absent when it can't be read.
  • used_bytes integer What your own docs take, in bytes.
  • allowance_bytes integer or null What you may hold in docs, in bytes: your plan's, plus any extra space bought; null without a plan.
  • used_percent integer The share used, 0 to 100.
  • used string In words, as the app's meter says it: "1.2 GB of 5 GB used".

GET/v1/days

Tables over several days.

Tables over a range of any length (years too), by day, with progress and tracked time, a page at a time: when the answer has a cursor, ask again with the same arguments and that cursor for the next page. Days with no tables are left out. Set detail to tasks for their tasks too. Repeating tables that haven't been created yet appear with planned: true. For totals over a long range, GET /v1/totals is shorter.

A key needs: read. Price: 1 Integration Credit.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/days?start_date=…&end_date=…"

Answer

• start_date string
• end_date string
• days list of object
  • date string
  • tables list of object
    • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
    • name string
    • date string The table's day, as YYYY-MM-DD.
    • shared boolean, optional True when other people can see the table.
    • your_role "owner", "admin", "member", "viewer", optional
    • completion_percent integer, optional
    • task_count integer, optional
    • completed_count integer, optional
    • tracked_minutes integer, optional Only for a table that tracks time, or one with tasks timed one by one (those alone count).
    • has_notes boolean, optional
    • planned boolean, optional True for a repeating table that hasn't been created for that day yet.
    • too_big boolean, optional True for a table with more than 1,000 tasks: too many to read here, so neither its tasks nor its progress are given. Open it in SelfManager.
    • tasks list of object, optional
      • task_id string, optional The task's id. A task of a repeating table not created yet has none.
      • name string
      • status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional
      • priority "critical", "high", "medium", "low", "minor", "optional"
      • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
      • duration_minutes integer, optional Tracked time of a completed task: in a table that tracks time, or a task timed one by one.
      • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
      • started_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
      • created_by_name string, optional
      • completed_by_name string, optional
      • deadline string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
      • deadline_met boolean, optional
• timezone string or null, optional The IANA timezone the answer was worked out in, or null when none is known.
• today string or null, optional Today's date in that timezone, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• cursor string, optional Present when there is more: ask again with the same arguments and this cursor for the next page. Absent on the last page.

GET/v1/totals

Totals over a range.

Totals over a range of any length (years too), per week or month: tables, tasks, completed tasks, completion and tracked time, also by table name. Every task counts as in GET /v1/days; repeating tables not created yet don't. Weeks or months with no tables are left out. A page at a time: when the answer has a cursor, ask again with the same arguments and that cursor. A period marked partial is split across pages: add up the parts with the same start.

A key needs: read. Price: 1 Integration Credit.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/totals?start_date=…&end_date=…"

Answer

• start_date string
• end_date string
• group_by "week", "month"
• periods list of object
  • start string The period's first day in the range, as YYYY-MM-DD.
  • end string Its last day in the range.
  • tables integer
  • too_big_tables integer, optional Of them, tables with more than 1,000 tasks: too many to read here, so their tasks aren't in these counts.
  • task_count integer
  • completed_count integer
  • completion_percent integer Progress of the tasks that count (canceled ones don't), by the same weights as a table's.
  • tracked_minutes integer, optional Where a table counts time: one that tracks time, or one with tasks timed one by one.
  • by_name list of object The 10 table names with the most tables, most first.
    • name string
    • tables integer
    • too_big_tables integer, optional Of them, tables with more than 1,000 tasks: too many to read here, so their tasks aren't in these counts.
    • task_count integer, optional
    • completed_count integer, optional
    • completion_percent integer, optional Progress of the tasks that count (canceled ones don't), by the same weights as a table's.
    • tracked_minutes integer, optional Where a table counts time: one that tracks time, or one with tasks timed one by one.
  • other_names object, optional Every other name, added up.
    • names integer How many other names.
    • tables integer, optional
    • too_big_tables integer, optional Of them, tables with more than 1,000 tasks: too many to read here, so their tasks aren't in these counts.
    • task_count integer, optional
    • completed_count integer, optional
    • completion_percent integer, optional Progress of the tasks that count (canceled ones don't), by the same weights as a table's.
    • tracked_minutes integer, optional Where a table counts time: one that tracks time, or one with tasks timed one by one.
  • partial boolean, optional True when another page holds the rest of this period.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• cursor string, optional Present when there is more: ask again with the same arguments and this cursor for the next page. Absent on the last page.

GET/v1/dates

Days with tables.

The days that have tables, each once with how many tables it has, over any range: all time when no dates are given. Days from today on also count the repeating tables planned there and not made yet (planned), through end_date; without end_date, only today's: give end_date to see repeats planned ahead. Without start_date it starts at your first day with a table, or today if that's earlier (end_date, if earlier still); without end_date it runs through your last day with a table, or today if that's later. A page at a time: when the answer has a cursor, ask again with the same arguments and that cursor, and add up the pages' counts. GET /v1/days lists the tables themselves.

A key needs: read. Price: 1 Integration Credit.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/dates"

Answer

• start_date string The first day read, as YYYY-MM-DD: the one asked for, or your first day with a table, or today if earlier (end_date, if earlier still).
• end_date string The last day read: the one asked for, or your last day with a table (today, if later).
• dates list of object
  • date string The day, as YYYY-MM-DD.
  • tables integer How many tables it has.
  • planned integer, optional How many repeating tables are planned on it and not made yet, through end_date or, without one, today; absent when none.
• date_count integer How many days this answer lists.
• table_count integer Their tables, added up.
• planned_count integer Their planned repeating tables, added up.
• timezone string or null, optional The IANA timezone the answer was worked out in, or null when none is known.
• today string or null, optional Today's date in that timezone, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• cursor string, optional Present when there is more: ask again with the same arguments and this cursor for the next page. Absent on the last page.

GET/v1/days/{date}

Tables on a day.

The tables on one day, with their tasks, progress and tracked time. Repeating tables that haven't been created yet appear with planned: true.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/days/<date>"

Answer

• date string The day, as YYYY-MM-DD.
• tables list of object
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string
  • date string The table's day, as YYYY-MM-DD.
  • shared boolean, optional True when other people can see the table.
  • your_role "owner", "admin", "member", "viewer", optional
  • completion_percent integer, optional
  • task_count integer, optional
  • completed_count integer, optional
  • tracked_minutes integer, optional Only for a table that tracks time, or one with tasks timed one by one (those alone count).
  • has_notes boolean, optional
  • planned boolean, optional True for a repeating table that hasn't been created for that day yet.
  • too_big boolean, optional True for a table with more than 1,000 tasks: too many to read here, so neither its tasks nor its progress are given. Open it in SelfManager.
  • tasks list of object, optional
    • task_id string, optional The task's id. A task of a repeating table not created yet has none.
    • name string
    • status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional
    • priority "critical", "high", "medium", "low", "minor", "optional"
    • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • duration_minutes integer, optional Tracked time of a completed task: in a table that tracks time, or a task timed one by one.
    • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • started_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • created_by_name string, optional
    • completed_by_name string, optional
    • deadline string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • deadline_met boolean, optional
• timezone string or null, optional The IANA timezone the answer was worked out in, or null when none is known.
• today string or null, optional Today's date in that timezone, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.

POST/v1/days/{date}/open

Open a day.

Make the repeating tables planned for a day (planned: true in GET /v1/days/{date}), exactly as opening that day in SelfManager does, and answer with the day's tables and every task's id. Only your own repeating tables, only from today on; nothing else changes, and a table already made is left as it is.

A key needs: read, write. Price: free.

Parameters

Body

• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  "https://api.selfmanager.ai/v1/days/<date>/open"

Answer

• date string The day, as YYYY-MM-DD.
• tables list of object
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string
  • date string The table's day, as YYYY-MM-DD.
  • shared boolean, optional True when other people can see the table.
  • your_role "owner", "admin", "member", "viewer", optional
  • completion_percent integer, optional
  • task_count integer, optional
  • completed_count integer, optional
  • tracked_minutes integer, optional Only for a table that tracks time, or one with tasks timed one by one (those alone count).
  • has_notes boolean, optional
  • planned boolean, optional True for a repeating table that hasn't been created for that day yet.
  • too_big boolean, optional True for a table with more than 1,000 tasks: too many to read here, so neither its tasks nor its progress are given. Open it in SelfManager.
  • tasks list of object, optional
    • task_id string, optional The task's id. A task of a repeating table not created yet has none.
    • name string
    • status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional
    • priority "critical", "high", "medium", "low", "minor", "optional"
    • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • duration_minutes integer, optional Tracked time of a completed task: in a table that tracks time, or a task timed one by one.
    • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • started_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • created_by_name string, optional
    • completed_by_name string, optional
    • deadline string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • deadline_met boolean, optional
• timezone string or null, optional The IANA timezone the answer was worked out in, or null when none is known.
• today string or null, optional Today's date in that timezone, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• changed boolean True: this request made at least one repeating table.
• made list of object The repeating tables this request made.
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string The table's name.
• not_made list of object, optional Planned ones SelfManager can't make from here, and why.
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string The table's name.
  • reason string
• note string, optional Something worth knowing: a day that has passed, or more to make.

GET/v1/tables/{date}/{table_key}

One table.

One table with every task, your deadlines on it, its notes, and its comments if asked. Completion times are kept on tables that track time, and for tasks timed one by one on others.

A key needs: read. Price: free.

For a table that someone else owns: GET /v1/tables/{date}/{table_key}/{owner_tag}

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• name string
• date string The table's day, as YYYY-MM-DD.
• shared boolean, optional True when other people can see the table.
• your_role "owner", "admin", "member", "viewer", optional
• completion_percent integer, optional
• task_count integer, optional
• completed_count integer, optional
• tracked_minutes integer, optional Only for a table that tracks time, or one with tasks timed one by one (those alone count).
• has_notes boolean, optional
• planned boolean, optional True for a repeating table that hasn't been created for that day yet.
• too_big boolean, optional True for a table with more than 1,000 tasks: too many to read here, so neither its tasks nor its progress are given. Open it in SelfManager.
• tasks list of object
  • task_id string, optional The task's id. A task of a repeating table not created yet has none.
  • name string
  • status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional
  • priority "critical", "high", "medium", "low", "minor", "optional"
  • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • duration_minutes integer, optional Tracked time of a completed task: in a table that tracks time, or a task timed one by one.
  • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • started_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • created_by_name string, optional
  • completed_by_name string, optional
  • deadline string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • deadline_met boolean, optional
• description string, optional
• notes string, optional The table's notes, as plain text.
• comments list of object, optional
  • comment_id string
  • author_name string, optional
  • by_you boolean
  • written_via string, optional The connected app that wrote it for its author, when one did.
  • text string
  • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • image_ids list of string, optional Its images, when it has any, while this connection may delete or see them.
  • recording_ids list of string, optional Its voice recordings, when it has any, while this connection may delete or listen to them.
• comments_cursor string, optional Pass it as cursor for the next page of comments. Absent on the last page.
• images list of object, optional The table's own images, newest first, while this connection may delete or see them.
  • image_id string
  • added_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
• recordings list of object, optional Voice recordings in its Audio section and notes, newest first, while this connection may delete or listen to them.
  • recording_id string
  • where "audio", "notes" The table's Audio section, or its notes.
  • added_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • length_seconds integer, optional
• docs list of object, optional The files in its Docs section, newest first, while this connection may read them.
  • doc_id string
  • file_name string
  • kind string
  • has_text boolean Whether GET /v1/tables/{date}/{table_key}/docs/{doc_id} has its text.
  • added_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
• people list of object, optional Who a comment of yours can @mention on this table, while this connection may mention people.
  • person_id string The id a comment's mentions name them by.
  • name string Write @ and this name in a comment that mentions them.
  • role "owner", "admin", "member", "viewer"
• planned_note string, optional
• timezone string or null The IANA timezone the answer was worked out in, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.

GET/v1/search

Search your tables.

Search the tables you own for a word or phrase (the exact text, in any case, not each word apart) in their name, description, tasks or notes, and in comments when fields includes comments, within a date window of any length (the last 30 days by default), newest first. One call looks through up to 1,000 tables: when the answer has a cursor, older tables in the window are left, so ask again with the same arguments and that cursor. It searches only tables you own: GET /v1/days/{date} and GET /v1/days read the ones others share with you.

A key needs: read. Price: 1 Integration Credit.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/search?query=…"

Answer

• query string
• date_from string
• date_to string
• results list of object
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string
  • date string
  • matched_in list of "name", "description", "tasks", "notes", "comments"
  • matching_tasks list of object
    • task_id string
    • name string
• searched string Which tables were searched.
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• cursor string, optional Present when there is more: ask again with the same arguments and this cursor for the next page. Absent on the last page.

GET/v1/pins

Pinned tables.

Your pinned tables, in their order, with their date and progress.

A key needs: read. Price: free.

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/pins"

Answer

• pins list of object
  • table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • name string
  • date string The table's day, as YYYY-MM-DD.
  • shared boolean, optional True when other people can see the table.
  • your_role "owner", "admin", "member", "viewer", optional
  • completion_percent integer, optional
  • task_count integer, optional
  • completed_count integer, optional
  • tracked_minutes integer, optional Only for a table that tracks time, or one with tasks timed one by one (those alone count).
  • has_notes boolean, optional
  • planned boolean, optional True for a repeating table that hasn't been created for that day yet.
  • too_big boolean, optional True for a table with more than 1,000 tasks: too many to read here, so neither its tasks nor its progress are given. Open it in SelfManager.
  • tasks list of object, optional
    • task_id string, optional The task's id. A task of a repeating table not created yet has none.
    • name string
    • status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional
    • priority "critical", "high", "medium", "low", "minor", "optional"
    • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • duration_minutes integer, optional Tracked time of a completed task: in a table that tracks time, or a task timed one by one.
    • created_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • started_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • created_by_name string, optional
    • completed_by_name string, optional
    • deadline string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
    • deadline_met boolean, optional
• truncated boolean True when something was left out or cut to keep the answer small.

GET/v1/deadlines

Deadlines.

Your deadlines, as the Deadlines page shows them: overdue, today, the next 7 days, later, or met. Grouping needs your timezone.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/deadlines"

Answer

• filter "overdue", "today", "week", "later", "completed", "all"
• timezone string or null The IANA timezone the answer was worked out in, or null when none is known.
• deadlines list of object
  • task_name string
  • table_name string
  • table_id string, optional The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
  • due_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
  • group "overdue", "today", "week", "later", "completed", optional Absent for an open deadline when the timezone isn't known.
  • completed_at string, optional A time as ISO 8601 with the timezone's offset, or in UTC (ending in Z) when the timezone isn't known.
• truncated boolean True when something was left out or cut to keep the answer small.

GET/v1/repeats

Repeating tables.

Your repeating tables: what repeats, how often, the next date, and whether it is paused. Each date it repeats on gets its own copy; changing one day's copy doesn't change the repeat. GET /v1/repeats/{repeat_id} reads one whole, and PATCH /v1/repeats/{repeat_id} changes it.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/repeats"

Answer

• repeats_enabled boolean False when repeating tables are switched off in Settings.
• repeats list of object
  • repeat_id string Its id, for GET /v1/repeats/{repeat_id} and PATCH /v1/repeats/{repeat_id}.
  • name string
  • cadence string How often, in words.
  • status "active", "paused"
  • next_date string, optional
  • start_date string, optional
  • end_date string, optional
• timezone string or null The IANA timezone the answer was worked out in, or null when none is known.
• truncated boolean True when something was left out or cut to keep the answer small.
• note string, optional

GET/v1/repeats/{repeat_id}

One repeating table.

One of your repeating tables whole: its schedule, and the name, description, tasks and notes each copy starts with, plus how many tables it has already made for today on. Its id comes from GET /v1/repeats.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/repeats/<repeat_id>"

Answer

• repeat_id string
• name string The name each copy gets.
• status "active", "paused"
• cadence string How often, in words.
• start_date string
• end_date string, optional
• next_date string, optional
• schedule object
  • frequency "daily", "weekly", "monthly"
  • interval integer Every this many days, weeks or months.
  • weekdays list of "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", optional
  • month_days list of integer, optional
• description string, optional
• tasks list of object
  • name string
  • priority "critical", "high", "medium", "low", "minor", "optional"
• too_big boolean, optional True when its blueprint has more than 1,000 tasks: too many to read here, so none are given.
• notes string, optional Its notes, as plain text.
• future_tables integer Tables it has already made, for today on.
• repeats_enabled boolean False when repeating tables are switched off in Settings.
• editable boolean Whether PATCH /v1/repeats/{repeat_id} can change it.
• timezone string or null
• truncated boolean

PATCH/v1/repeats/{repeat_id}

Change a repeating table.

Change a repeating table as SelfManager's Repeats page does: what each new copy starts with (name, description, the whole task list, notes as plain text that replaces them), the schedule, the end date (null removes it), or pause and resume it. Tables already made keep the old version unless also_update_future is true: then those for today on that nobody worked in, and nobody else can see, are updated too, never their notes. It never deletes a repeat or changes its start date.

Give at least one of name, description, tasks, notes, schedule, end_date, status and also_update_future.

A key needs: read, write. Price: free.

Parameters

Body

• name string, optional
• description string, optional "" removes it.
• tasks list of object, optional The whole new task list, in order: tasks left out are removed.
  • name string
  • priority "critical", "high", "medium", "low", "minor", "optional", optional critical, high, medium, low, minor or optional (the default).
• notes string, optional Plain text that replaces the notes (each line a paragraph; their formatting isn't kept); "" removes them.
• schedule object, optional
  • frequency "daily", "weekly", "monthly"
  • interval integer, optional Every this many days, weeks or months (default 1).
  • weekdays list of "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", optional Weekly only: the days.
  • month_days list of integer, optional Monthly only: the days of the month (the 31st falls on a short month's last day).
• end_date string or null, optional The last date it repeats on, as YYYY-MM-DD; null removes the end.
• status "active", "paused", optional paused stops new copies; active resumes.
• also_update_future boolean, optional Also update the tables it already made for today on that nobody worked in (default false).
• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X PATCH -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"name":"Call the bank"}' \
  "https://api.selfmanager.ai/v1/repeats/<repeat_id>"

Answer

• repeat_id string
• name string The name each copy gets.
• status "active", "paused"
• cadence string How often, in words.
• start_date string
• end_date string, optional
• next_date string, optional
• changed boolean
• changed_fields list of "name", "description", "tasks", "notes", "schedule", "end_date", "status"
• future_tables object, optional With also_update_future: what happened to the tables already made for today on.
  • updated integer, optional
  • already_current integer, optional
  • left_alone_worked_in integer, optional
  • left_alone_shared integer, optional
  • not_updated integer, optional
  • not_reached integer, optional
• note string, optional
• truncated boolean

GET/v1/journal

Journal.

Your daily journal (self messages) for one date, or a range of any length, a page at a time: when the answer has a cursor, ask again with the same arguments and that cursor. Without a date it uses today, which needs your timezone.

A key needs: read, journal. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/journal"

Answer

• start_date string
• end_date string
• entries list of object
  • date string
  • text string
• truncated boolean True when something was left out or cut to keep the answer small.
• hint string, optional What to ask for instead, when something was left out.
• cursor string, optional Present when there is more: ask again with the same arguments and this cursor for the next page. Absent on the last page.

GET/v1/ai-history

Your AI History.

The conversations saved in your AI History, newest first: SelfManager's AI Reviews, tables' AI chats, and those an assistant saved. Titles, kinds, dates and a short preview, a page at a time: when the answer has a cursor, ask again with it for older ones. GET /v1/ai-history/{conversation_id} reads one.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/ai-history"

Answer

• conversations list of object
  • conversation_id string
  • title string
  • kind "ai_review", "table_chat", "pinned_tables", "assistant", "other" ai_review: SelfManager's AI Review; table_chat: a table's AI chat; pinned_tables: the pinned tables' chat; assistant: one an assistant saved.
  • type "summary", "chat", "follow_up"
  • created_at string
  • entry_count integer
  • app string, optional The assistant that saved it, for kind assistant.
  • period string, optional The period a review covers.
  • table_name string, optional
  • preview string, optional
• truncated boolean
• cursor string, optional
• hint string, optional

POST/v1/ai-history

Save to AI History.

Save a review or a chat to your AI History in SelfManager, where it shows beside the app's own AI Reviews, marked as the API's. Plain text: entries in order, each user or assistant. It can't be changed or deleted through the API afterwards.

A key needs: read, write. Price: 1 Integration Credit.

Parameters

Body

• title string A short title.
• kind "review", "chat"
• period object, optional
  • start_date string A date as YYYY-MM-DD, from 2000 to 2099.
  • end_date string A date as YYYY-MM-DD, from 2000 to 2099.
• entries list of object
  • role "user", "assistant"
  • text string

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"title":"…","kind":"review","entries":[{"role":"user","text":"…"}]}' \
  "https://api.selfmanager.ai/v1/ai-history"

Answer

• conversation_id string
• title string
• entry_count integer
• saved_at string

GET/v1/ai-history/{conversation_id}

One AI History conversation.

One conversation from your AI History, its entries in order as plain text (role user or assistant), a page of them at a time: when the answer has a cursor, ask again with it.

A key needs: read. Price: free.

Parameters

Example

curl -H "Authorization: Bearer $SELFMANAGER_KEY" \
  "https://api.selfmanager.ai/v1/ai-history/<conversation_id>"

Answer

• conversation_id string
• title string
• kind "ai_review", "table_chat", "pinned_tables", "assistant", "other" ai_review: SelfManager's AI Review; table_chat: a table's AI chat; pinned_tables: the pinned tables' chat; assistant: one an assistant saved.
• type "summary", "chat", "follow_up"
• created_at string
• entry_count integer
• app string, optional The assistant that saved it, for kind assistant.
• period string, optional The period a review covers.
• table_name string, optional
• updated_at string, optional
• entries list of object
  • role "user", "assistant"
  • text string
• truncated boolean
• cursor string, optional
• hint string, optional

POST/v1/tables

Create a table.

Create one table of yours on a day, with up to 200 tasks and optional notes. For several tables, or one table on many days, use POST /v1/tables/batch: one call. To add tasks to a table that exists, use POST /v1/tables/{date}/{table_key}/tasks. Time isn't tracked unless track_time is true, as in the app. Give an Idempotency-Key header to make a retry safe.

A key needs: read, write. Price: 1 Integration Credit or more, by what it makes (Prices).

Parameters

Body

• date string A date as YYYY-MM-DD, from 2000 to 2099.
• name string The table's name.
• description string, optional Optional description.
• tasks list of object, optional
  • name string What to do.
  • priority "critical", "high", "medium", "low", "minor", "optional", optional critical, high, medium, low, minor or optional (the default).
• notes string, optional Optional notes, as plain text: each line becomes a paragraph.
• track_time boolean, optional Track time on its tasks (default false).

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"date":"…","name":"…"}' \
  "https://api.selfmanager.ai/v1/tables"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• name string The table's name.
• date string The table's day, as YYYY-MM-DD.
• tasks list of object
  • task_id string
  • name string
  • priority "critical", "high", "medium", "low", "minor", "optional"
• has_notes boolean
• tracks_time boolean

POST/v1/tables/batch

Create many tables.

Create up to 1,000 tables of yours in one request, on any days, several on one day too. Each entry is one table on its date, or the same table on each of its dates, with up to 200 tasks and optional notes, as POST /v1/tables makes them. The Idempotency-Key header is required: when a request times out, or answers 504 having run out of time, send it again with the same key to make what is missing, never anything twice.

A key needs: read, write. Price: 1 Integration Credit or more, by what it makes (Prices).

Parameters

Body

• tables list of object The tables, in the order to make them.
  • date string, optional The day, as YYYY-MM-DD. Give date or dates.
  • dates list of string, optional The same table on each of these days, each day once. Give date or dates.
  • name string The table's name.
  • description string, optional Optional description.
  • tasks list of object, optional Up to 200 tasks.
    • name string What to do.
    • priority "critical", "high", "medium", "low", "minor", "optional", optional critical, high, medium, low, minor or optional (the default).
  • notes string, optional Optional notes, as plain text: each line becomes a paragraph.
  • track_time boolean, optional Track time on its tasks (default false).

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"tables":[{"name":"…"}]}' \
  "https://api.selfmanager.ai/v1/tables/batch"

Answer

• table_count integer How many tables the request made, in all.
• first_date string The first day a table was made on.
• last_date string The last day a table was made on.
• tables list of object Each entry's tables, in the order sent. GET /v1/tables/{date}/{table_key} shows a table's tasks.
  • name string
  • table_ids list of string One per date, in the order sent.
• note string, optional Something worth knowing, such as tables an earlier attempt made.

POST/v1/tables/{date}/{table_key}/tasks

Add tasks.

Add up to 200 tasks at the end of a table. A repeating table that hasn't been created for that day yet is created first. In a table other people can see (one shared with you, one of yours you share, or one with an invitation waiting), the key needs the shared permission.

A key needs: read, write. Price: 1 Integration Credit or more, by what it makes (Prices).

For a table that someone else owns: POST /v1/tables/{date}/{table_key}/{owner_tag}/tasks

Parameters

Body

• tasks list of object
  • name string What to do.
  • priority "critical", "high", "medium", "low", "minor", "optional", optional critical, high, medium, low, minor or optional (the default).
• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"tasks":[{"name":"…"}]}' \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/tasks"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• tasks list of object
  • task_id string
  • name string
  • priority "critical", "high", "medium", "low", "minor", "optional"
• note string, optional Something worth knowing about what happened: a repeating table created first, or an earlier attempt of the same request found to have done it already.

PATCH/v1/tables/{date}/{table_key}/tasks/{task_id}

Update a task.

Rename a task, change its priority, or set its progress short of completed (POST /v1/tables/{date}/{table_key}/tasks/{task_id}/complete and POST /v1/tables/{date}/{table_key}/tasks/{task_id}/reopen change that). Progress canceled leaves a task out of the table's progress, and keeps it; deleting it is DELETE /v1/tables/{date}/{table_key}/tasks/{task_id}'s, where that is listed. Renaming works only in tables nobody else can read.

Give at least one of name, priority and progress.

A key needs: read, write. Price: free.

For a table that someone else owns: PATCH /v1/tables/{date}/{table_key}/{owner_tag}/tasks/{task_id}

Parameters

Body

• name string, optional The new name.
• priority "critical", "high", "medium", "low", "minor", "optional", optional critical, high, medium, low, minor or optional.
• progress "not_started", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional How far along it is, short of completed.

Example

curl -X PATCH -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"name":"Call the bank"}' \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/tasks/<task_id>"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• task_id string
• name string The task's name.
• status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled", optional The task's progress as it reads now.
• changed boolean False when the task already read that way, so nothing was written.
• note string, optional Something worth knowing about what happened, or why nothing did.
• priority "critical", "high", "medium", "low", "minor", "optional", optional
• changed_fields list of "status", "name", "priority", optional What was changed, when something was.

POST/v1/tables/{date}/{table_key}/tasks/{task_id}/complete

Complete a task.

Mark a task completed, as ticking it in SelfManager does: its time, who completed it, its deadline and the table's log. Works on your tables and on tables shared with you where you're an admin or member, not a viewer. A task of a table with planned: true has no task_id until POST /v1/days/{date}/open makes that day's copies. A task already completed is left as it is.

A key needs: read, write. Price: free.

For a table that someone else owns: POST /v1/tables/{date}/{table_key}/{owner_tag}/tasks/{task_id}/complete

Parameters

Body

• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/tasks/<task_id>/complete"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• task_id string
• name string The task's name.
• status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled" The task's progress as it reads now.
• changed boolean False when the task already read that way, so nothing was written.
• note string, optional Something worth knowing about what happened, or why nothing did.
• deadline "met", "restored", optional What happens to the task's deadline, when it has one: met, for everyone it reminds, or back.
• tracked_time_deleted boolean, optional True when reopening deleted the time recorded for the task.

POST/v1/tables/{date}/{table_key}/tasks/{task_id}/reopen

Reopen a task.

Mark a completed task as not started again, as unticking it in SelfManager does. This deletes the time recorded for it, and brings its deadline back.

A key needs: read, write. Price: free.

For a table that someone else owns: POST /v1/tables/{date}/{table_key}/{owner_tag}/tasks/{task_id}/reopen

Parameters

Body

• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/tasks/<task_id>/reopen"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• task_id string
• name string The task's name.
• status "not_started", "completed", "almost_completed", "done_something", "checked_a_little", "did_overview", "canceled" The task's progress as it reads now.
• changed boolean False when the task already read that way, so nothing was written.
• note string, optional Something worth knowing about what happened, or why nothing did.
• deadline "met", "restored", optional What happens to the task's deadline, when it has one: met, for everyone it reminds, or back.
• tracked_time_deleted boolean, optional True when reopening deleted the time recorded for the task.

POST/v1/tables/{date}/{table_key}/comments

Add a comment.

Add a comment, as you, to a table. Plain text; @mentions aren't sent. In a table other people can see (one shared with you, one of yours you share, or one with an invitation waiting), the key needs the shared permission.

A key needs: read, write. Price: 1 Integration Credit.

For a table that someone else owns: POST /v1/tables/{date}/{table_key}/{owner_tag}/comments

Parameters

Body

• text string The comment.
• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"text":"…"}' \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/comments"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• comment_id string
• note string, optional Something worth knowing about what happened: a repeating table created first, or an earlier attempt of the same request found to have done it already.
• mentioned integer, optional How many of the people it mentions were told.

POST/v1/tables/{date}/{table_key}/notes

Add to a table's notes.

Add text at the end of a table's notes: each line becomes a paragraph. The version before stays one undo away in SelfManager. In a table other people can see (one shared with you, one of yours you share, or one with an invitation waiting), the key needs the shared permission.

A key needs: read, write. Price: 1 Integration Credit.

For a table that someone else owns: POST /v1/tables/{date}/{table_key}/{owner_tag}/notes

Parameters

Body

• text string The text, as plain text.
• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"text":"…"}' \
  "https://api.selfmanager.ai/v1/tables/<date>/<table_key>/notes"

Answer

• table_id string The table's id: YYYY-MM-DD/tableKey, with a third part when someone else owns the table.
• table_name string The table's name.
• changed boolean True: the text is at the end of the notes.
• note string, optional Something worth knowing about what happened: a repeating table created first, or an earlier attempt of the same request found to have done it already.

POST/v1/journal/{date}

Add to your journal.

Add text to a day's journal line (your self message for that day), after a space; line breaks become spaces.

A key needs: read, journal, write. Price: 1 Integration Credit.

Parameters

Body

• text string The text to add.
• timezone string, optional Optional IANA timezone, such as Europe/Bucharest. Defaults to the one SelfManager stored for you.

Example

curl -X POST -H "Authorization: Bearer $SELFMANAGER_KEY" \
  -H "Idempotency-Key: a-key-of-your-own" \
  -H "Content-Type: application/json" \
  -d '{"text":"…"}' \
  "https://api.selfmanager.ai/v1/journal/<date>"

Answer

• date string The day written to, as YYYY-MM-DD.
• changed boolean
• entry string That day's journal line as it reads now, cut when it is long.
• truncated boolean True when the line shown was cut.
• note string, optional Something worth knowing about what happened: a repeating table created first, or an earlier attempt of the same request found to have done it already.