# projects

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.

| Method | Path | Title | Access | Price | MCP tool |
| --- | --- | --- | --- | --- | --- |
| GET | [`/v1/me/projects`](#get-my-projects) | Your projects | `read:projects` | 0 | `get_my_projects` |
| POST | [`/v1/me/projects`](#create-my-project) | Make a project | `write:projects` | 0 | `create_my_project` |
| PATCH | [`/v1/me/projects/{project_id}`](#update-my-project) | Change a project | `write:projects` | 0 | `update_my_project` |

`GET /v1/me/projects`

## Your projects
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.

### Parameters
- `project_id` string · query  
  One project's ID (proj_…): the list then holds only it.  
  pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `archived` boolean · query  
  true lists your archived projects instead.  
  default false

### Response
`200` Your projects.

- `object` const · required  
  Always `project_list`.  
  Always `"project_list"`.
- `archived` boolean · required  
  Whether these are your archived projects.
- `total` integer · required  
  How many there are.
- `projects` array of object · required  
  The projects.
  - `id` string · required  
    Its ID (proj_…).
  - `object` const · required  
    Always `project`.  
    Always `"project"`.
  - `name` string · required  
    Its name, your own words.
  - `colour` string  
    Its colour in the sidebar.  
    One of: `gray`, `blue`, `teal`, `green`, `amber`, `red`, `purple`, `pink` (open: new values may be added).
  - `type` string · required  
    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_mode` string · required  
    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_id` string · nullable  
    Its twin: the real-money project made from a paper one, or the paper one it came from.
  - `leagues` array of string · required  
    The leagues it holds, in your order.
  - `settings` object · required  
    Its settings. Its loss limits are read with the limits operations and its project_id.
    - `bankroll_share` number · nullable  
      Its share of your bankroll, 0 to 1. A paper project takes none.
    - `staking` object  
      Its staking rule; null parts use your account's.
      - `unit` number · nullable  
        One unit, in your own currency.
      - `kelly_fraction` number · nullable  
        The fraction of the Kelly criterion, 0.2 to 0.5.
      - `max_bet_share` number · nullable  
        The most one bet may take of its bankroll, 0 to 1.
    - `books` array of string · nullable  
      The books it uses; null uses your account's.
    - `state` string · nullable  
      The state it bets in; null uses your account's.
    - `instructions` string · nullable  
      Your instructions for answers asked in it, your own words.
    - `league` string · nullable  
      Its first league (lg_…), the same as leagues[0].
    - `board` array of string  
      Its home board: your artifacts pinned to its page (art_…), in your order.
  - `session_count` integer  
    How many sessions it holds.
  - `pinned_at` string · nullable  
    When you pinned it.  
    format date-time
  - `archived_at` string · nullable  
    When you archived it.  
    format date-time
  - `created_at` string · nullable  
    When you made it.  
    format date-time
  - `updated_at` string · nullable  
    When it last changed.  
    format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/me/projects
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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"
    }
  ]
}
```

```http
GET https://api.askkelly.ai/v1/me/projects?project_id=proj_00000000000000000000
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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 project
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.

### Parameters
Body, `application/json` (required):

- `name` string  
  Its name, at most 80 characters.  
  min length 1 · max length 320
- `colour` string  
  Its colour in the sidebar.  
  One of: `gray`, `blue`, `teal`, `green`, `amber`, `red`, `purple`, `pink` (open: new values may be added).
- `type` string  
  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).
- `leagues` array of string  
  The leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.
- `settings` object  
  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.
  - `bankroll_share` number · nullable  
    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
  - `staking` object · nullable  
    Its staking rule.
    - `unit` number · nullable  
      One unit, in your own currency.
    - `kelly_fraction` number · nullable  
      0.2 to 0.5, such as 0.25 for quarter Kelly.  
      min 0.2 · max 0.5
    - `max_bet_share` number · nullable  
      Above 0 to 1.  
      max 1
  - `books` array of string · nullable  
    Book slugs such as draftkings.
  - `state` string · nullable  
    A state Kelly carries, such as NJ.  
    pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$
  - `instructions` string · nullable  
    Your instructions for answers asked in it.
  - `league` string · nullable  
    Its first league (lg_…); the others stay. Not with leagues.  
    pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$
  - `board` array of string · nullable  
    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_mode` string  
  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).

### Response
`201` The project, made.

- `id` string · required  
  Its ID (proj_…).
- `object` const · required  
  Always `project`.  
  Always `"project"`.
- `name` string · required  
  Its name, your own words.
- `colour` string  
  Its colour in the sidebar.  
  One of: `gray`, `blue`, `teal`, `green`, `amber`, `red`, `purple`, `pink` (open: new values may be added).
- `type` string · required  
  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_mode` string · required  
  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_id` string · nullable  
  Its twin: the real-money project made from a paper one, or the paper one it came from.
- `leagues` array of string · required  
  The leagues it holds, in your order.
- `settings` object · required  
  Its settings. Its loss limits are read with the limits operations and its project_id.
  - `bankroll_share` number · nullable  
    Its share of your bankroll, 0 to 1. A paper project takes none.
  - `staking` object  
    Its staking rule; null parts use your account's.
    - `unit` number · nullable  
      One unit, in your own currency.
    - `kelly_fraction` number · nullable  
      The fraction of the Kelly criterion, 0.2 to 0.5.
    - `max_bet_share` number · nullable  
      The most one bet may take of its bankroll, 0 to 1.
  - `books` array of string · nullable  
    The books it uses; null uses your account's.
  - `state` string · nullable  
    The state it bets in; null uses your account's.
  - `instructions` string · nullable  
    Your instructions for answers asked in it, your own words.
  - `league` string · nullable  
    Its first league (lg_…), the same as leagues[0].
  - `board` array of string  
    Its home board: your artifacts pinned to its page (art_…), in your order.
- `session_count` integer  
  How many sessions it holds.
- `pinned_at` string · nullable  
  When you pinned it.  
  format date-time
- `archived_at` string · nullable  
  When you archived it.  
  format date-time
- `created_at` string · nullable  
  When you made it.  
  format date-time
- `updated_at` string · nullable  
  When it last changed.  
  format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

### Example
```http
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."
  }
}
```

```json
{
  "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"
}
```

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

{
  "name": "Test mode"
}
```

```json
{
  "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."
}
```

```http
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"
}
```

```json
{
  "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."
}
```

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

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

```json
{
  "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 project
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.

### Parameters
- `project_id` string · path · required  
  The project's ID (proj_…).  
  pattern ^proj_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, `application/json` (required):

- `name` string  
  Its name, at most 80 characters.  
  min length 1 · max length 320
- `colour` string  
  Its colour in the sidebar.  
  One of: `gray`, `blue`, `teal`, `green`, `amber`, `red`, `purple`, `pink` (open: new values may be added).
- `type` string  
  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).
- `leagues` array of string  
  The leagues it holds, in your order: IDs of leagues you connected (lg_…). It replaces the list; an empty list clears it.
- `settings` object  
  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.
  - `bankroll_share` number · nullable  
    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
  - `staking` object · nullable  
    Its staking rule.
    - `unit` number · nullable  
      One unit, in your own currency.
    - `kelly_fraction` number · nullable  
      0.2 to 0.5, such as 0.25 for quarter Kelly.  
      min 0.2 · max 0.5
    - `max_bet_share` number · nullable  
      Above 0 to 1.  
      max 1
  - `books` array of string · nullable  
    Book slugs such as draftkings.
  - `state` string · nullable  
    A state Kelly carries, such as NJ.  
    pattern ^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$
  - `instructions` string · nullable  
    Your instructions for answers asked in it.
  - `league` string · nullable  
    Its first league (lg_…); the others stay. Not with leagues.  
    pattern ^lg_[0-9a-hjkmnp-tv-z]{20}$
  - `board` array of string · nullable  
    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.
- `pinned` boolean  
  true pins it to the top of your list; false unpins it.
- `archived` boolean  
  true archives it (it leaves your list and frees its bankroll share); false brings it back.

### Response
`200` The project after the change.

- `id` string · required  
  Its ID (proj_…).
- `object` const · required  
  Always `project`.  
  Always `"project"`.
- `name` string · required  
  Its name, your own words.
- `colour` string  
  Its colour in the sidebar.  
  One of: `gray`, `blue`, `teal`, `green`, `amber`, `red`, `purple`, `pink` (open: new values may be added).
- `type` string · required  
  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_mode` string · required  
  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_id` string · nullable  
  Its twin: the real-money project made from a paper one, or the paper one it came from.
- `leagues` array of string · required  
  The leagues it holds, in your order.
- `settings` object · required  
  Its settings. Its loss limits are read with the limits operations and its project_id.
  - `bankroll_share` number · nullable  
    Its share of your bankroll, 0 to 1. A paper project takes none.
  - `staking` object  
    Its staking rule; null parts use your account's.
    - `unit` number · nullable  
      One unit, in your own currency.
    - `kelly_fraction` number · nullable  
      The fraction of the Kelly criterion, 0.2 to 0.5.
    - `max_bet_share` number · nullable  
      The most one bet may take of its bankroll, 0 to 1.
  - `books` array of string · nullable  
    The books it uses; null uses your account's.
  - `state` string · nullable  
    The state it bets in; null uses your account's.
  - `instructions` string · nullable  
    Your instructions for answers asked in it, your own words.
  - `league` string · nullable  
    Its first league (lg_…), the same as leagues[0].
  - `board` array of string  
    Its home board: your artifacts pinned to its page (art_…), in your order.
- `session_count` integer  
  How many sessions it holds.
- `pinned_at` string · nullable  
  When you pinned it.  
  format date-time
- `archived_at` string · nullable  
  When you archived it.  
  format date-time
- `created_at` string · nullable  
  When you made it.  
  format date-time
- `updated_at` string · nullable  
  When it last changed.  
  format date-time

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

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

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

```json
{
  "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."
}
```

```http
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
}
```

```json
{
  "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.

---

Generated from Kelly API 2026-10-05

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Data is the edge. Odds are information, not advice · 21+ · Get help
