mirror of
https://github.com/LukeHagar/dub-node.git
synced 2025-12-06 04:19:37 +00:00
163 lines
14 KiB
Markdown
163 lines
14 KiB
Markdown
# Workspaces
|
|
(*workspaces*)
|
|
|
|
### Available Operations
|
|
|
|
* [list](#list) - Retrieve a list of workspaces
|
|
* [create](#create) - Create a workspace
|
|
* [get](#get) - Retrieve a workspace
|
|
|
|
## list
|
|
|
|
Retrieve a list of workspaces for the authenticated user.
|
|
|
|
### Example Usage
|
|
|
|
```typescript
|
|
import { Dub } from "dub";
|
|
|
|
const dub = new Dub({
|
|
token: "DUB_API_KEY",
|
|
});
|
|
|
|
async function run() {
|
|
const result = await dub.workspaces.list();
|
|
|
|
// Handle the result
|
|
console.log(result)
|
|
}
|
|
|
|
run();
|
|
```
|
|
|
|
### Parameters
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
|
|
|
|
### Response
|
|
|
|
**Promise\<[components.WorkspaceSchema[]](../../models/.md)\>**
|
|
### Errors
|
|
|
|
| Error Object | Status Code | Content Type |
|
|
| -------------------------- | -------------------------- | -------------------------- |
|
|
| errors.BadRequest | 400 | application/json |
|
|
| errors.Unauthorized | 401 | application/json |
|
|
| errors.Forbidden | 403 | application/json |
|
|
| errors.NotFound | 404 | application/json |
|
|
| errors.Conflict | 409 | application/json |
|
|
| errors.InviteExpired | 410 | application/json |
|
|
| errors.UnprocessableEntity | 422 | application/json |
|
|
| errors.RateLimitExceeded | 429 | application/json |
|
|
| errors.InternalServerError | 500 | application/json |
|
|
| errors.SDKError | 4xx-5xx | */* |
|
|
|
|
## create
|
|
|
|
Create a new workspace for the authenticated user.
|
|
|
|
### Example Usage
|
|
|
|
```typescript
|
|
import { Dub } from "dub";
|
|
|
|
const dub = new Dub({
|
|
token: "DUB_API_KEY",
|
|
});
|
|
|
|
async function run() {
|
|
const result = await dub.workspaces.create({
|
|
name: "<value>",
|
|
slug: "<value>",
|
|
});
|
|
|
|
// Handle the result
|
|
console.log(result)
|
|
}
|
|
|
|
run();
|
|
```
|
|
|
|
### Parameters
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| `request` | [operations.CreateWorkspaceRequestBody](../../models/operations/createworkspacerequestbody.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
|
|
|
|
### Response
|
|
|
|
**Promise\<[components.WorkspaceSchema](../../models/components/workspaceschema.md)\>**
|
|
### Errors
|
|
|
|
| Error Object | Status Code | Content Type |
|
|
| -------------------------- | -------------------------- | -------------------------- |
|
|
| errors.BadRequest | 400 | application/json |
|
|
| errors.Unauthorized | 401 | application/json |
|
|
| errors.Forbidden | 403 | application/json |
|
|
| errors.NotFound | 404 | application/json |
|
|
| errors.Conflict | 409 | application/json |
|
|
| errors.InviteExpired | 410 | application/json |
|
|
| errors.UnprocessableEntity | 422 | application/json |
|
|
| errors.RateLimitExceeded | 429 | application/json |
|
|
| errors.InternalServerError | 500 | application/json |
|
|
| errors.SDKError | 4xx-5xx | */* |
|
|
|
|
## get
|
|
|
|
Retrieve a workspace for the authenticated user.
|
|
|
|
### Example Usage
|
|
|
|
```typescript
|
|
import { Dub } from "dub";
|
|
|
|
const dub = new Dub({
|
|
token: "DUB_API_KEY",
|
|
});
|
|
|
|
async function run() {
|
|
const result = await dub.workspaces.get({
|
|
idOrSlug: "<value>",
|
|
});
|
|
|
|
// Handle the result
|
|
console.log(result)
|
|
}
|
|
|
|
run();
|
|
```
|
|
|
|
### Parameters
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| `request` | [operations.GetWorkspaceRequest](../../models/operations/getworkspacerequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
|
|
|
|
### Response
|
|
|
|
**Promise\<[components.WorkspaceSchema](../../models/components/workspaceschema.md)\>**
|
|
### Errors
|
|
|
|
| Error Object | Status Code | Content Type |
|
|
| -------------------------- | -------------------------- | -------------------------- |
|
|
| errors.BadRequest | 400 | application/json |
|
|
| errors.Unauthorized | 401 | application/json |
|
|
| errors.Forbidden | 403 | application/json |
|
|
| errors.NotFound | 404 | application/json |
|
|
| errors.Conflict | 409 | application/json |
|
|
| errors.InviteExpired | 410 | application/json |
|
|
| errors.UnprocessableEntity | 422 | application/json |
|
|
| errors.RateLimitExceeded | 429 | application/json |
|
|
| errors.InternalServerError | 500 | application/json |
|
|
| errors.SDKError | 4xx-5xx | */* |
|