Skip to main content
GET
/
{team_id}
/
projects
Get all projects
curl --request GET \
  --url https://api.superthread.com/v1/{team_id}/projects \
  --header 'Authorization: Bearer <token>'
{
  "cursor": "dmsjqh9d8w1hdjosjaasda",
  "count": 14,
  "project_order": {},
  "projects": [
    {
      "id": "421",
      "team_id": "tDsu0j19",
      "title": "My Project",
      "description": "<string>",
      "overview_page_id": "<string>",
      "user_id": "u-dsu0j19",
      "user_id_updated": "uDsu0j19",
      "user": {
        "user_id": "uDsu0j19",
        "type": "user",
        "source": {
          "type": "oauth",
          "client_id": "oczapier",
          "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
          "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
          "email_addr": "somebody@example.com",
          "email_verified": false
        }
      },
      "user_updated": {
        "user_id": "uDsu0j19",
        "type": "user",
        "source": {
          "type": "oauth",
          "client_id": "oczapier",
          "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
          "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
          "email_addr": "somebody@example.com",
          "email_verified": false
        }
      },
      "time_created": 1608742037016,
      "time_updated": 1608742037016,
      "time_expires": 1608742037016,
      "members": [
        {
          "user_id": "u-dsu0j19",
          "assigned_date": 1608742037016,
          "role": "admin"
        }
      ],
      "is_member": true,
      "total_members": 7,
      "total_members_online": 2,
      "is_public": true,
      "is_private": true,
      "page_order": [
        {}
      ],
      "pages": [
        {
          "id": "<string>",
          "title": "<string>"
        }
      ],
      "trashed": {
        "user_deleted": {
          "user_id": "uDsu0j19",
          "type": "user",
          "source": {
            "type": "oauth",
            "client_id": "oczapier",
            "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
            "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
            "email_addr": "somebody@example.com",
            "email_verified": false
          }
        },
        "time_deleted": 1608742037016
      },
      "archive_page_order": [
        {}
      ],
      "archive_pages": [
        {
          "id": "<string>",
          "title": "<string>"
        }
      ],
      "board_order": {},
      "boards": [
        {
          "id": "<string>",
          "title": "<string>"
        }
      ],
      "sprints": [
        {
          "id": "<string>",
          "title": "<string>",
          "start_date": 1608742037016,
          "end_date": 1608742037016
        }
      ],
      "estimate_system": "",
      "is_view_only": true
    }
  ],
  "total_projects_count": 100,
  "total_boards_count": 100
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
team_id
string
required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

Query Parameters

​
trash
boolean
default:false

Flag whether to fetch projects in trash only

Response

Array of team projects visible to current user

​
cursor
string
required
Example:

"dmsjqh9d8w1hdjosjaasda"

​
count
integer
required
Example:

14

​
project_order
object

string array representing an order of IDs

​
projects
object[]
​
total_projects_count
integer
Example:

100

​
total_boards_count
integer
Example:

100