Skip to content
Kellydocs
Kellydocs

projects

Copy page

Read, make and change your projects: a workspace for one fantasy league or many, a betting strategy, a paper bankroll, rule tests, or anything else.

On this page
MethodPathTitleAccessPriceMCP tool
GET/v1/me/projectsYour projectsread:projects0get_my_projects
POST/v1/me/projectsMake a projectwrite:projects0create_my_project
PATCH/v1/me/projects/{project_id}Change a projectwrite:projects0update_my_project

GET /v1/me/projects

Your projectsLink to this section

scope read:projects · 0 credits, not charged during the beta · MCP tool get_my_projects · status live

Your projects, pinned first then newest first: each one's ID, name, type (general, fantasy (one league or many), betting (a betting strategy with its share of your bankroll) or rule_lab (rule tests and their charts)), money mode (real, or paper for a paper bankroll), its twin, the leagues it holds, its settings (bankroll share, staking rule, books, state and your instructions) and how many sessions it holds. project_id returns one; archived=true lists the archived ones. A project's loss limits are read and set with the limits operations and its project_id.

ParametersLink to this section

project_idstring · query

One project's ID (proj_…): the list then holds only it.

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

archivedboolean · query

true lists your archived projects instead.

default false

ResponseLink to this section

200 Your projects.

objectconstrequired

Always project_list.

Always "project_list".

archivedbooleanrequired

Whether these are your archived projects.

totalintegerrequired

How many there are.

projectsarray of objectrequired

The projects.

Show 14 fields
idstringrequired

Its ID (proj_…).

objectconstrequired

Always project.

Always "project".

namestringrequired

Its name, your own words.

colourstring

Its colour in the sidebar.

One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).

typestringrequired

What it is for: general (anything), fantasy (one league or many), betting (a betting strategy and its share of your bankroll) or rule_lab (rule tests and their charts). It picks the project's defaults, never its data, and you can change it.

One of: general, fantasy, betting, rule_lab (open: new values may be added).

money_modestringrequired

real, or paper for a paper bankroll. Set when the project is made and never changed.

One of: real, paper (open: new values may be added).

twin_idstringnullable

Its twin: the real-money project made from a paper one, or the paper one it came from.

leaguesarray of stringrequired

The leagues it holds, in your order.

settingsobjectrequired

Its settings. Its loss limits are read with the limits operations and its project_id.

Show 7 fields
bankroll_sharenumbernullable

Its share of your bankroll, 0 to 1. A paper project takes none.

stakingobject

Its staking rule; null parts use your account's.

Show 3 fields
unitnumbernullable

One unit, in your own currency.

kelly_fractionnumbernullable

The fraction of the Kelly criterion, 0.2 to 0.5.

max_bet_sharenumbernullable

The most one bet may take of its bankroll, 0 to 1.

booksarray of stringnullable

The books it uses; null uses your account's.

statestringnullable

The state it bets in; null uses your account's.

instructionsstringnullable

Your instructions for answers asked in it, your own words.

leaguestringnullable

Its first league (lg_…), the same as leagues[0].

boardarray of string

Its home board: your artifacts pinned to its page (art_…), in your order.

session_countinteger

How many sessions it holds.

pinned_atstringnullable

When you pinned it.

format date-time

archived_atstringnullable

When you archived it.

format date-time

created_atstringnullable

When you made it.

format date-time

updated_atstringnullable

When it last changed.

format date-time

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · not_found

ExampleLink to this section

Request
GET https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Response, 200
{
  "object": "project_list",
  "archived": false,
  "total": 2,
  "projects": [
    {
      "id": "proj_rg7a6xkgej0stz9x3grg",
      "object": "project",
      "name": "Paper run",
      "colour": "gray",
      "type": "betting",
      "money_mode": "paper",
      "twin_id": null,
      "leagues": [],
      "settings": {
        "bankroll_share": null,
        "staking": {
          "unit": null,
          "kelly_fraction": null,
          "max_bet_share": null
        },
        "books": null,
        "state": null,
        "instructions": null,
        "league": null,
        "board": []
      },
      "session_count": 0,
      "pinned_at": null,
      "archived_at": null,
      "created_at": "2026-10-04T17:30:00+00:00",
      "updated_at": "2026-10-04T17:30:00+00:00"
    },
    {
      "id": "proj_2mp2e2be43ex6f0qg5w7",
      "object": "project",
      "name": "NFL totals",
      "colour": "gray",
      "type": "betting",
      "money_mode": "real",
      "twin_id": null,
      "leagues": [],
      "settings": {
        "bankroll_share": 0.25,
        "staking": {
          "unit": null,
          "kelly_fraction": 0.25,
          "max_bet_share": null
        },
        "books": null,
        "state": null,
        "instructions": "Totals only. Tell me when the number moved against me.",
        "league": null,
        "board": []
      },
      "session_count": 0,
      "pinned_at": null,
      "archived_at": null,
      "created_at": "2026-10-04T17:30:00+00:00",
      "updated_at": "2026-10-04T17:30:00+00:00"
    }
  ]
}
Request
GET https://api.askkelly.ai/v1/me/projects?project_id=proj_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
Response, 404
{
  "type": "https://docs.askkelly.ai/problems/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No such project.",
  "param": "project_id",
  "doc_url": "https://docs.askkelly.ai/problems/not_found",
  "request_id": "req_27c4b141bedaa259052c3db2",
  "retryable": false,
  "display_message": "That could not be found."
}

POST /v1/me/projects

Make a projectLink to this section

scope write:projects · 0 credits, not charged during the beta · MCP tool create_my_project · status live

Makes a project: its name, what it is for (general, fantasy (one league or many), betting (a betting strategy with its share of your bankroll) or rule_lab (rule tests and their charts); general when left out), its money mode, the leagues it holds and its settings. Paper is for betting and rule_lab projects, takes no share of your bankroll and can never be changed to real afterwards. Your real-money projects' bankroll shares total at most 1. A project's loss limits are read and set with the limits operations and its project_id. Needs your own live API key with write:projects; an AI app makes and changes projects through Kelly MCP.

ParametersLink to this section

Body, application/json (required):

namestring

Its name, at most 80 characters.

min length 1 · max length 320

colourstring

Its colour in the sidebar.

One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).

typestring

What it is for: general (anything), fantasy (one league or many), betting (a betting strategy and its share of your bankroll) or rule_lab (rule tests and their charts).

One of: general, fantasy, betting, rule_lab (open: new values may be added).

leaguesarray of string

The leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.

settingsobject

Settings to change; a null clears one to your account's. Limits are not set here: use the limits operations with the project's ID.

Show 7 fields
bankroll_sharenumbernullable

Its share of your bankroll, above 0 to 1; your real-money projects' shares total at most 1. A paper project takes none.

max 1

stakingobjectnullable

Its staking rule.

Show 3 fields
unitnumbernullable

One unit, in your own currency.

kelly_fractionnumbernullable

0.2 to 0.5, such as 0.25 for quarter Kelly.

min 0.2 · max 0.5

max_bet_sharenumbernullable

Above 0 to 1.

max 1

booksarray of stringnullable

Book slugs such as draftkings.

statestringnullable

A state Kelly carries, such as NJ.

pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$

instructionsstringnullable

Your instructions for answers asked in it.

leaguestringnullable

Its first league (lg_…); the others stay. Not with leagues.

pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$

boardarray of stringnullable

Its home board: IDs of your artifacts to pin to its page (art_…), in order. It replaces the list; null or an empty list clears it.

money_modestring

real (the default) or paper, for a paper bankroll. Paper is for betting and rule_lab projects, and is fixed once the project is made; with paper and no type, the type is betting.

One of: real, paper (open: new values may be added).

ResponseLink to this section

201 The project, made.

idstringrequired

Its ID (proj_…).

objectconstrequired

Always project.

Always "project".

namestringrequired

Its name, your own words.

colourstring

Its colour in the sidebar.

One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).

typestringrequired

What it is for: general (anything), fantasy (one league or many), betting (a betting strategy and its share of your bankroll) or rule_lab (rule tests and their charts). It picks the project's defaults, never its data, and you can change it.

One of: general, fantasy, betting, rule_lab (open: new values may be added).

money_modestringrequired

real, or paper for a paper bankroll. Set when the project is made and never changed.

One of: real, paper (open: new values may be added).

twin_idstringnullable

Its twin: the real-money project made from a paper one, or the paper one it came from.

leaguesarray of stringrequired

The leagues it holds, in your order.

settingsobjectrequired

Its settings. Its loss limits are read with the limits operations and its project_id.

Show 7 fields
bankroll_sharenumbernullable

Its share of your bankroll, 0 to 1. A paper project takes none.

stakingobject

Its staking rule; null parts use your account's.

Show 3 fields
unitnumbernullable

One unit, in your own currency.

kelly_fractionnumbernullable

The fraction of the Kelly criterion, 0.2 to 0.5.

max_bet_sharenumbernullable

The most one bet may take of its bankroll, 0 to 1.

booksarray of stringnullable

The books it uses; null uses your account's.

statestringnullable

The state it bets in; null uses your account's.

instructionsstringnullable

Your instructions for answers asked in it, your own words.

leaguestringnullable

Its first league (lg_…), the same as leagues[0].

boardarray of string

Its home board: your artifacts pinned to its page (art_…), in your order.

session_countinteger

How many sessions it holds.

pinned_atstringnullable

When you pinned it.

format date-time

archived_atstringnullable

When you archived it.

format date-time

created_atstringnullable

When you made it.

format date-time

updated_atstringnullable

When it last changed.

format date-time

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found

ExampleLink to this section

Request
POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "name": "NFL totals", "type": "betting", "settings": { "bankroll_share": 0.25, "staking": { "kelly_fraction": 0.25 }, "instructions": "Totals only. Tell me when the number moved against me." } }

Response, 201
{
  "id": "proj_2mp2e2be43ex6f0qg5w7",
  "object": "project",
  "name": "NFL totals",
  "colour": "gray",
  "type": "betting",
  "money_mode": "real",
  "twin_id": null,
  "leagues": [],
  "settings": {
    "bankroll_share": 0.25,
    "staking": {
      "unit": null,
      "kelly_fraction": 0.25,
      "max_bet_share": null
    },
    "books": null,
    "state": null,
    "instructions": "Totals only. Tell me when the number moved against me.",
    "league": null,
    "board": []
  },
  "session_count": 0,
  "pinned_at": null,
  "archived_at": null,
  "created_at": "2026-10-04T17:30:00+00:00",
  "updated_at": "2026-10-04T17:30:00+00:00"
}
Request
POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "name": "Test mode" }

Response, 403
{
  "type": "https://docs.askkelly.ai/problems/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "code": "insufficient_scope",
  "detail": "This needs the write:projects scope.",
  "param": "write:projects",
  "doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
  "request_id": "req_a986a662c0aa19be1ef443a0",
  "retryable": false,
  "display_message": "This app needs one more permission to do that."
}
Request
POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "name": "My leagues", "type": "fantasy", "money_mode": "paper" }

Response, 400
{
  "type": "https://docs.askkelly.ai/problems/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "A paper project is a Betting strategy or a Rule lab project.",
  "param": "type",
  "doc_url": "https://docs.askkelly.ai/problems/invalid_request",
  "request_id": "req_71688df9bee25852a83bb9a2",
  "retryable": false,
  "display_message": "Something in that request was not understood."
}
Request
POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "name": "Paper run", "money_mode": "paper" }

Response, 201
{
  "id": "proj_rg7a6xkgej0stz9x3grg",
  "object": "project",
  "name": "Paper run",
  "colour": "gray",
  "type": "betting",
  "money_mode": "paper",
  "twin_id": null,
  "leagues": [],
  "settings": {
    "bankroll_share": null,
    "staking": {
      "unit": null,
      "kelly_fraction": null,
      "max_bet_share": null
    },
    "books": null,
    "state": null,
    "instructions": null,
    "league": null,
    "board": []
  },
  "session_count": 0,
  "pinned_at": null,
  "archived_at": null,
  "created_at": "2026-10-04T17:30:00+00:00",
  "updated_at": "2026-10-04T17:30:00+00:00"
}

PATCH /v1/me/projects/{project_id}

Change a projectLink to this section

scope write:projects · 0 credits, not charged during the beta · MCP tool update_my_project · status live

Renames, recolours, retypes, pins or archives one of your projects, replaces the leagues it holds, or changes its settings (a null clears one to your account's). Archiving can be undone with archived false; deleting a project is on askkelly.ai. The money mode never changes. A project's loss limits are read and set with the limits operations and its project_id. Needs your own live API key with write:projects; an AI app makes and changes projects through Kelly MCP.

ParametersLink to this section

project_idstring · pathrequired

The project's ID (proj_…).

pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, application/json (required):

namestring

Its name, at most 80 characters.

min length 1 · max length 320

colourstring

Its colour in the sidebar.

One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).

typestring

What it is for: general (anything), fantasy (one league or many), betting (a betting strategy and its share of your bankroll) or rule_lab (rule tests and their charts).

One of: general, fantasy, betting, rule_lab (open: new values may be added).

leaguesarray of string

The leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.

settingsobject

Settings to change; a null clears one to your account's. Limits are not set here: use the limits operations with the project's ID.

Show 7 fields
bankroll_sharenumbernullable

Its share of your bankroll, above 0 to 1; your real-money projects' shares total at most 1. A paper project takes none.

max 1

stakingobjectnullable

Its staking rule.

Show 3 fields
unitnumbernullable

One unit, in your own currency.

kelly_fractionnumbernullable

0.2 to 0.5, such as 0.25 for quarter Kelly.

min 0.2 · max 0.5

max_bet_sharenumbernullable

Above 0 to 1.

max 1

booksarray of stringnullable

Book slugs such as draftkings.

statestringnullable

A state Kelly carries, such as NJ.

pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$

instructionsstringnullable

Your instructions for answers asked in it.

leaguestringnullable

Its first league (lg_…); the others stay. Not with leagues.

pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$

boardarray of stringnullable

Its home board: IDs of your artifacts to pin to its page (art_…), in order. It replaces the list; null or an empty list clears it.

pinnedboolean

true pins it to the top of your list; false unpins it.

archivedboolean

true archives it (it leaves your list and frees its bankroll share); false brings it back.

ResponseLink to this section

200 The project after the change.

idstringrequired

Its ID (proj_…).

objectconstrequired

Always project.

Always "project".

namestringrequired

Its name, your own words.

colourstring

Its colour in the sidebar.

One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).

typestringrequired

What it is for: general (anything), fantasy (one league or many), betting (a betting strategy and its share of your bankroll) or rule_lab (rule tests and their charts). It picks the project's defaults, never its data, and you can change it.

One of: general, fantasy, betting, rule_lab (open: new values may be added).

money_modestringrequired

real, or paper for a paper bankroll. Set when the project is made and never changed.

One of: real, paper (open: new values may be added).

twin_idstringnullable

Its twin: the real-money project made from a paper one, or the paper one it came from.

leaguesarray of stringrequired

The leagues it holds, in your order.

settingsobjectrequired

Its settings. Its loss limits are read with the limits operations and its project_id.

Show 7 fields
bankroll_sharenumbernullable

Its share of your bankroll, 0 to 1. A paper project takes none.

stakingobject

Its staking rule; null parts use your account's.

Show 3 fields
unitnumbernullable

One unit, in your own currency.

kelly_fractionnumbernullable

The fraction of the Kelly criterion, 0.2 to 0.5.

max_bet_sharenumbernullable

The most one bet may take of its bankroll, 0 to 1.

booksarray of stringnullable

The books it uses; null uses your account's.

statestringnullable

The state it bets in; null uses your account's.

instructionsstringnullable

Your instructions for answers asked in it, your own words.

leaguestringnullable

Its first league (lg_…), the same as leagues[0].

boardarray of string

Its home board: your artifacts pinned to its page (art_…), in your order.

session_countinteger

How many sessions it holds.

pinned_atstringnullable

When you pinned it.

format date-time

archived_atstringnullable

When you archived it.

format date-time

created_atstringnullable

When you made it.

format date-time

updated_atstringnullable

When it last changed.

format date-time

ErrorsLink to this section

invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · insufficient_scope · not_entitled · payload_too_large · not_found

ExampleLink to this section

Request
PATCH https://api.askkelly.ai/v1/me/projects/proj_2mp2e2be43ex6f0qg5w7
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "settings": { "limits": { "day": 50 } } }

Response, 400
{
  "type": "https://docs.askkelly.ai/problems/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "settings.limits: a project's limits are changed with set_my_limits (PATCH /v1/me/limits) and its project_id.",
  "param": "settings.limits",
  "doc_url": "https://docs.askkelly.ai/problems/invalid_request",
  "request_id": "req_df3efe1777fd11ca87b0a9d7",
  "retryable": false,
  "display_message": "Something in that request was not understood."
}
Request
PATCH https://api.askkelly.ai/v1/me/projects/proj_2mp2e2be43ex6f0qg5w7
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json

{ "name": "NFL totals 2026", "pinned": true }

Response, 200
{
  "id": "proj_2mp2e2be43ex6f0qg5w7",
  "object": "project",
  "name": "NFL totals 2026",
  "colour": "gray",
  "type": "betting",
  "money_mode": "real",
  "twin_id": null,
  "leagues": [],
  "settings": {
    "bankroll_share": 0.25,
    "staking": {
      "unit": null,
      "kelly_fraction": 0.25,
      "max_bet_share": null
    },
    "books": null,
    "state": null,
    "instructions": "Totals only. Tell me when the number moved against me.",
    "league": null,
    "board": []
  },
  "session_count": 0,
  "pinned_at": "2026-10-04T17:30:00+00:00",
  "archived_at": null,
  "created_at": "2026-10-04T17:30:00+00:00",
  "updated_at": "2026-10-04T17:30:00+00:00"
}

Generated from Kelly API 2026-10-05.

Support: support@askkelly.ai · Security and disclosure