# Agent: Image Generation

**Page:** api/agent/image-gen

[Download Raw Markdown](./api/agent/image-gen.md)

---

{/* AUTO-GENERATED — Do not edit manually. Regenerate with: npm run docs:api:generate */}



## Get Image Generation Status

Use this endpoint to check the configuration and authentication status of the image generation backend for a workspace. The response indicates whether image generation is enabled, which provider and model are configured, and whether the credentials are valid.

### `GET /api/v1/workspaces/{workspaceID}/image-gen/status`

### Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `workspaceID` | path | string | Yes | The ID of the workspace to query. |

### Response



```json
{
  "enabled": true,
  "model": "dall-e-3",
  "provider": "openai",
  "authenticated": true
}
```



### SDK Usage

```ts
const status = await client.agent.imageGen.getStatus({
  workspaceID: "ws_abc123"
});

console.log(status.enabled);
console.log(status.authenticated);
```