List project templates

GET

/project-templates

GET

/project-templates

1 curl https:/https://api/project-templates \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json"

1 {
2   "templates": [
3     {
4       "_id": "64b8f9a2e4b0c123456789ab",
5       "name": "Marketing Campaign",
6       "description": "Template for launching and managing marketing campaigns across channels.",
7       "icon": "📈",
8       "prefix": "MKT",
9       "sections": [
10         {
11           "planning": {
12             "tasks": [
13               "Define goals",
14               "Identify target audience",
15               "Set budget"
16             ]
17           }
18         },
19         {
20           "execution": {
21             "tasks": [
22               "Create content",
23               "Schedule posts",
24               "Launch ads"
25             ]
26           }
27         },
28         {
29           "analysis": {
30             "tasks": [
31               "Track KPIs",
32               "Generate reports",
33               "Optimize campaigns"
34             ]
35           }
36         }
37       ],
38       "useAccess": {
39         "roles": [
40           "marketing_manager",
41           "content_creator"
42         ],
43         "userIds": [
44           "user_12345",
45           "user_67890"
46         ]
47       },
48       "defaultProjectAccess": {
49         "roles": [
50           "project_member"
51         ],
52         "userIds": []
53       },
54       "archivedAt": null,
55       "createdAt": "2024-05-20T10:15:30Z",
56       "updatedAt": "2024-06-01T08:45:00Z",
57       "createdBy": "admin_user_001"
58     }
59   ]
60 }

Lists the organization’s project templates, most recently created first. Archived templates are excluded unless archived=true.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Query parameters

archivedbooleanOptional

Set true to include archived templates.

Response

The organization's project templates.

templateslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error