You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/developer-resources/rest-apis/index.mdx
+70Lines changed: 70 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,76 @@ Additional information on the REST APIs is provided below.
19
19
- When querying using v3 apis, see [v3 Where Clause](/docs/product-docs/developer-resources/rest-apis#v3-where-query-parameter) for a slight difference between the two version's where clause.
20
20
21
21
22
+
## Finding Your API IDs
23
+
24
+
Before making API calls, you'll need to identify and copy the relevant IDs required for constructing your endpoints. This section walks you through locating each essential identifier.
25
+
26
+
### Workspace ID
27
+
28
+
The Workspace ID identifies your entire workspace and is used for workspace-level API operations.
29
+
30
+
Workspace ID is the alphanumeric string with prefix `w` (stands for workspace) that appears in the URL when viewing any base within your workspace. It can also be found in the Workspace context menu (down chevron next to workspace name) in the left sidebar. Click on the ID to copy it to your clipboard.
The Base ID is required for meta APIs and administrative operations. It identifies a specific database / base within your workspace.
41
+
42
+
Base ID is the alphanumeric string with prefix `p` (stands for project) that appears in the URL when viewing any table or base-level settings. It can also be found in the Base context menu (chevron next to base name) in the left sidebar. Click on the ID to copy it to your clipboard.
43
+
44
+

45
+
46
+
### Table ID
47
+
48
+
The Table ID is the most frequently used identifier and is required for all data API calls. It uniquely identifies a specific table within your base.
49
+
50
+
Table ID is the alphanumeric string with prefix `m` (stands for model) that appears after base ID in the URL when viewing a table. It can also be found in Table context menu (three dots next to table name) in the left sidebar. Click on the ID to copy it to your clipboard.
51
+
52
+

53
+
54
+
### View ID
55
+
The View ID is used for view-specific API operations, such as retrieving records from a particular view. It uniquely identifies a specific view within a table.
56
+
57
+
View ID is the alphanumeric string with prefix `v` (stands for view) that appears in the URL when viewing a specific view. It can also be found in the View context menu (three dots next to view name) in the left sidebar. Click on the ID to copy it to your clipboard.
58
+
59
+

60
+
61
+
View ID can also be retrieved from view toolbar > more actions (...) menu
62
+
63
+

64
+
65
+
66
+
### Field ID
67
+
The Field ID is used for field-specific API operations, such as updating field properties. It uniquely identifies a specific column within a table.
68
+
69
+
Field ID is the alphanumeric string with prefix `c` (stands for column) that appears in the URL when viewing or editing a specific field's settings. It can also be found in the field context menu (chevron next to field name) in field header bar. Click on the ID to copy it to your clipboard.
70
+
71
+

72
+
73
+
Field ID can also be retrieved from `Details` > `Fields` editor
74
+
75
+

76
+
77
+
### User ID
78
+
The User ID is used for user-specific API operations, such as retrieving user details. It uniquely identifies a specific user within your workspace / organization.
79
+
80
+
User ID is the alphanumeric string with prefix `u` (stands for user). You can retrieve it from either workspace members page or base members page by clicking on the three dots menu associated with user's name. Click on the ID to copy it to your clipboard.
For External Data Sources connected to NocoDB (like Postgres / MySQL), the Data Source ID is additionally required to perform data API operations.
86
+
87
+
Data Source ID is the alphanumeric string with prefix `ds` (stands for data source). You can retrieve it from the context menu by clicking on the three dots next to data source name in the left sidebar. Click on the ID to copy it to your clipboard.
NocoDB APIs are rate-limited to ensure fair usage and optimal performance for all users. The default rate limit is set to **5 requests per second per user**. These limits are the same across all plans.
0 commit comments