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
| Method | Path | Title | Access | Price | MCP tool |
|---|---|---|---|---|---|
| GET | /v1/me/projects | Your projects | read:projects | 0 | get_my_projects |
| POST | /v1/me/projects | Make a project | write:projects | 0 | create_my_project |
| PATCH | /v1/me/projects/{project_id} | Change a project | write:projects | 0 | update_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 · queryOne project's ID (proj_…): the list then holds only it.
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
archivedboolean · querytrue lists your archived projects instead.
default false
ResponseLink to this section
200 Your projects.
objectconstrequiredAlways project_list.
Always "project_list".
archivedbooleanrequiredWhether these are your archived projects.
totalintegerrequiredHow many there are.
projectsarray of objectrequiredThe projects.
Show 14 fields
idstringrequiredIts ID (proj_…).
objectconstrequiredAlways project.
Always "project".
namestringrequiredIts name, your own words.
colourstringIts colour in the sidebar.
One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).
typestringrequiredWhat 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_modestringrequiredreal, 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_idstringnullableIts twin: the real-money project made from a paper one, or the paper one it came from.
leaguesarray of stringrequiredThe leagues it holds, in your order.
settingsobjectrequiredIts settings. Its loss limits are read with the limits operations and its project_id.
Show 7 fields
stakingobjectIts staking rule; null parts use your account's.
Show 3 fields
unitnumbernullableOne unit, in your own currency.
kelly_fractionnumbernullableThe fraction of the Kelly criterion, 0.2 to 0.5.
booksarray of stringnullableThe books it uses; null uses your account's.
statestringnullableThe state it bets in; null uses your account's.
instructionsstringnullableYour instructions for answers asked in it, your own words.
leaguestringnullableIts first league (lg_…), the same as leagues[0].
boardarray of stringIts home board: your artifacts pinned to its page (art_…), in your order.
session_countintegerHow many sessions it holds.
pinned_atstringnullableWhen you pinned it.
format date-time
archived_atstringnullableWhen you archived it.
format date-time
created_atstringnullableWhen you made it.
format date-time
updated_atstringnullableWhen 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
GET https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY{
"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"
}
]
}GET https://api.askkelly.ai/v1/me/projects?project_id=proj_00000000000000000000
Authorization: Bearer $KELLY_API_KEY{
"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):
namestringIts name, at most 80 characters.
min length 1 · max length 320
colourstringIts colour in the sidebar.
One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).
typestringWhat 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 stringThe leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.
settingsobjectSettings 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
stakingobjectnullableIts staking rule.
Show 3 fields
unitnumbernullableOne unit, in your own currency.
kelly_fractionnumbernullable0.2 to 0.5, such as 0.25 for quarter Kelly.
min 0.2 · max 0.5
booksarray of stringnullableBook slugs such as draftkings.
statestringnullableA state Kelly carries, such as NJ.
pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$
instructionsstringnullableYour instructions for answers asked in it.
leaguestringnullableIts first league (lg_…); the others stay. Not with leagues.
pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$
boardarray of stringnullableIts 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_modestringreal (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.
idstringrequiredIts ID (proj_…).
objectconstrequiredAlways project.
Always "project".
namestringrequiredIts name, your own words.
colourstringIts colour in the sidebar.
One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).
typestringrequiredWhat 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_modestringrequiredreal, 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_idstringnullableIts twin: the real-money project made from a paper one, or the paper one it came from.
leaguesarray of stringrequiredThe leagues it holds, in your order.
settingsobjectrequiredIts settings. Its loss limits are read with the limits operations and its project_id.
Show 7 fields
stakingobjectIts staking rule; null parts use your account's.
Show 3 fields
unitnumbernullableOne unit, in your own currency.
kelly_fractionnumbernullableThe fraction of the Kelly criterion, 0.2 to 0.5.
booksarray of stringnullableThe books it uses; null uses your account's.
statestringnullableThe state it bets in; null uses your account's.
instructionsstringnullableYour instructions for answers asked in it, your own words.
leaguestringnullableIts first league (lg_…), the same as leagues[0].
boardarray of stringIts home board: your artifacts pinned to its page (art_…), in your order.
session_countintegerHow many sessions it holds.
pinned_atstringnullableWhen you pinned it.
format date-time
archived_atstringnullableWhen you archived it.
format date-time
created_atstringnullableWhen you made it.
format date-time
updated_atstringnullableWhen 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
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."
}
}
{
"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"
}POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"name": "Test mode"
}
{
"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."
}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"
}
{
"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."
}POST https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"name": "Paper run",
"money_mode": "paper"
}
{
"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 · pathrequiredThe project's ID (proj_…).
pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
Body, application/json (required):
namestringIts name, at most 80 characters.
min length 1 · max length 320
colourstringIts colour in the sidebar.
One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).
typestringWhat 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 stringThe leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.
settingsobjectSettings 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
stakingobjectnullableIts staking rule.
Show 3 fields
unitnumbernullableOne unit, in your own currency.
kelly_fractionnumbernullable0.2 to 0.5, such as 0.25 for quarter Kelly.
min 0.2 · max 0.5
booksarray of stringnullableBook slugs such as draftkings.
statestringnullableA state Kelly carries, such as NJ.
pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$
instructionsstringnullableYour instructions for answers asked in it.
leaguestringnullableIts first league (lg_…); the others stay. Not with leagues.
pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$
boardarray of stringnullableIts 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.
pinnedbooleantrue pins it to the top of your list; false unpins it.
archivedbooleantrue 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.
idstringrequiredIts ID (proj_…).
objectconstrequiredAlways project.
Always "project".
namestringrequiredIts name, your own words.
colourstringIts colour in the sidebar.
One of: gray, blue, teal, green, amber, red, purple, pink (open: new values may be added).
typestringrequiredWhat 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_modestringrequiredreal, 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_idstringnullableIts twin: the real-money project made from a paper one, or the paper one it came from.
leaguesarray of stringrequiredThe leagues it holds, in your order.
settingsobjectrequiredIts settings. Its loss limits are read with the limits operations and its project_id.
Show 7 fields
stakingobjectIts staking rule; null parts use your account's.
Show 3 fields
unitnumbernullableOne unit, in your own currency.
kelly_fractionnumbernullableThe fraction of the Kelly criterion, 0.2 to 0.5.
booksarray of stringnullableThe books it uses; null uses your account's.
statestringnullableThe state it bets in; null uses your account's.
instructionsstringnullableYour instructions for answers asked in it, your own words.
leaguestringnullableIts first league (lg_…), the same as leagues[0].
boardarray of stringIts home board: your artifacts pinned to its page (art_…), in your order.
session_countintegerHow many sessions it holds.
pinned_atstringnullableWhen you pinned it.
format date-time
archived_atstringnullableWhen you archived it.
format date-time
created_atstringnullableWhen you made it.
format date-time
updated_atstringnullableWhen 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
PATCH https://api.askkelly.ai/v1/me/projects/proj_2mp2e2be43ex6f0qg5w7
Authorization: Bearer $KELLY_API_KEY
Content-Type: application/json{
"settings": {
"limits": {
"day": 50
}
}
}
{
"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."
}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
}
{
"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.