# Workspace

> Every teams, members, tags, widgets, SLA, and settings query and mutation.

Product: Clad API
Source: https://docs.useclad.ai/api/reference-workspace

---

Teams, members, tags, widgets, SLA policies, and workspace settings.

### Queries

#### `apiInfo`

```graphql
apiInfo: JSON
```

Public API metadata: version, schema hash, and server time.

#### `autoResponseSettings`

```graphql
autoResponseSettings: AutoResponseSettings
```

#### `members`

```graphql
members: [Member!]
```

All members of the authenticated organization.

#### `node`

```graphql
node(id: ID!): Node
```

Fetch any node-capable object by its globally unique opaque id.

| Argument | Type | Description |
| --- | --- | --- |
| `id` | `ID!` | Required. |

#### `nodes`

```graphql
nodes(ids: [ID!]!): [Node]!
```

Fetch up to 50 nodes by globally unique opaque ids (null for unknown/foreign ids).

| Argument | Type | Description |
| --- | --- | --- |
| `ids` | `[ID!]!` | Required. |

#### `slaPolicies`

```graphql
slaPolicies: [SlaPolicy!]
```

The org's SLA policies with version history (evaluation order).

#### `supportHoursSchedules`

```graphql
supportHoursSchedules: [SupportHoursSchedule!]
```

The org's support-hours schedules (with intervals and holidays).

#### `tags`

```graphql
tags: [Tag!]
```

All workspace tags, alphabetical.

#### `teams`

```graphql
teams: [Team!]
```

All teams in the organization, each with its members.

#### `widget`

```graphql
widget(id: ID): Widget
```

A widget by id. Omit id to get (and lazily provision) the org's default widget.

| Argument | Type | Description |
| --- | --- | --- |
| `id` | `ID` |  |

#### `widgetForms`

```graphql
widgetForms: [WidgetForm!]
```

All widget intake forms for the organization.

#### `widgets`

```graphql
widgets: [Widget!]
```

#### `workspaceSettings`

```graphql
workspaceSettings: WorkspaceSettings
```

### Mutations

#### `addTeamMembers`

```graphql
addTeamMembers(profileIds: [ID!]!, teamId: ID!): TeamResult
```

Add org members to a team (skips profiles already on the team).

| Argument | Type | Description |
| --- | --- | --- |
| `profileIds` | `[ID!]!` | Opaque Profile ids of org members to add. |
| `teamId` | `ID!` | Required. |

#### `createTag`

```graphql
createTag(input: CreateTagInput!): TagResult
```

Create a workspace tag.

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `CreateTagInput!` | Required. |

#### `createTeam`

```graphql
createTeam(name: String!): TeamResult
```

Create a team.

| Argument | Type | Description |
| --- | --- | --- |
| `name` | `String!` | Required. |

#### `createWidget`

```graphql
createWidget(name: String): WidgetResult
```

Create an additional web widget (the org's first widget is the default).

| Argument | Type | Description |
| --- | --- | --- |
| `name` | `String` |  |

#### `createWidgetForm`

```graphql
createWidgetForm(input: CreateWidgetFormInput!): WidgetFormResult
```

Create a widget intake form (org-unique slug).

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `CreateWidgetFormInput!` | Required. |

#### `deleteTag`

```graphql
deleteTag(id: ID!): DeleteTagResult
```

Delete a tag and strip it from every issue and account.

| Argument | Type | Description |
| --- | --- | --- |
| `id` | `ID!` | Required. |

#### `deleteTeam`

```graphql
deleteTeam(teamId: ID!): DeleteTeamResult
```

Delete a team (memberships and issue assignments cascade).

| Argument | Type | Description |
| --- | --- | --- |
| `teamId` | `ID!` | Required. |

#### `deleteWidget`

```graphql
deleteWidget(id: ID!): DeleteWidgetResult
```

Delete a web widget. Default resolution falls back to the earliest remaining widget.

| Argument | Type | Description |
| --- | --- | --- |
| `id` | `ID!` | Required. |

#### `deleteWidgetForm`

```graphql
deleteWidgetForm(id: ID!): DeleteWidgetFormResult
```

Delete a widget intake form.

| Argument | Type | Description |
| --- | --- | --- |
| `id` | `ID!` | Required. |

#### `removeTeamMember`

```graphql
removeTeamMember(profileId: ID!, teamId: ID!): TeamResult
```

Remove a member from a team.

| Argument | Type | Description |
| --- | --- | --- |
| `profileId` | `ID!` | Opaque Profile id of the member to remove. |
| `teamId` | `ID!` | Required. |

#### `renameTeam`

```graphql
renameTeam(name: String!, teamId: ID!): TeamResult
```

Rename a team.

| Argument | Type | Description |
| --- | --- | --- |
| `name` | `String!` | Required. |
| `teamId` | `ID!` | Required. |

#### `updateAutoResponseSettings`

```graphql
updateAutoResponseSettings(input: UpdateAutoResponseInput!): AutoResponseResult
```

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `UpdateAutoResponseInput!` | Required. |

#### `updateTag`

```graphql
updateTag(input: UpdateTagInput!): TagResult
```

Rename/recolor a tag. Renames cascade to every issue and account carrying it.

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `UpdateTagInput!` | Required. |

#### `updateWidget`

```graphql
updateWidget(input: UpdateWidgetInput!): WidgetResult
```

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `UpdateWidgetInput!` | Required. |

#### `updateWidgetForm`

```graphql
updateWidgetForm(input: UpdateWidgetFormInput!): WidgetFormResult
```

Update a widget intake form (name, slug, fields, enabled).

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `UpdateWidgetFormInput!` | Required. |

#### `updateWorkspaceSettings`

```graphql
updateWorkspaceSettings(input: UpdateWorkspaceSettingsInput!): WorkspaceSettingsResult
```

| Argument | Type | Description |
| --- | --- | --- |
| `input` | `UpdateWorkspaceSettingsInput!` | Required. |