# ArtifactService

> The ArtifactService methods and their request and response messages.

Source: https://engramsfactory.com/docs/api/artifact/

Generated from [`artifact.proto`](https://github.com/cortexapps/engrams/blob/main/crates/engram-protocol/proto/engram/app/v1/artifact.proto). Every method is
`POST /rpc/engram.app.v1.ArtifactService/<Method>` with a JSON or protobuf body and an
`x-api-key` header.

## Methods

| Method | Request | Response |
|---|---|---|
| `ListArtifacts` | [`ListArtifactsRequest`](#listartifactsrequest) | [`ListArtifactsResponse`](#listartifactsresponse) |
| `GetArtifactRecord` | [`GetArtifactRecordRequest`](#getartifactrecordrequest) | [`GetArtifactRecordResponse`](#getartifactrecordresponse) |
| `SetArtifactVisibility` | [`SetArtifactVisibilityRequest`](#setartifactvisibilityrequest) | [`SetArtifactVisibilityResponse`](#setartifactvisibilityresponse) |
| `DeleteArtifact` | [`DeleteArtifactRequest`](#deleteartifactrequest) | [`DeleteArtifactResponse`](#deleteartifactresponse) |

## Messages

### ArtifactRecord

| Field | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `file_name` | `string` |
| `owner_user_id` | `string` (optional) |
| `created_by` | `User` (optional) |
| `visibility` | `string` |
| `current_version` | `int32` |
| `media_type` | `string` |
| `size_bytes` | `uint64` |
| `created_at` | `string` |
| `updated_at` | `string` |
| `raw_url` | `string` |
| `versions` | repeated [`ArtifactVersionRecord`](#artifactversionrecord) |

### ArtifactVersionRecord

| Field | Type |
|---|---|
| `version` | `int32` |
| `session_id` | `string` |
| `task_id` | `string` (optional) |
| `media_type` | `string` |
| `size_bytes` | `uint64` |
| `created_at` | `string` |

### DeleteArtifactRequest

| Field | Type |
|---|---|
| `id` | `string` |

### DeleteArtifactResponse

| Field | Type |
|---|---|
| `deleted` | `bool` |

### GetArtifactRecordRequest

| Field | Type |
|---|---|
| `id` | `string` |

### GetArtifactRecordResponse

| Field | Type |
|---|---|
| `artifact` | [`ArtifactRecord`](#artifactrecord) |

### ListArtifactsRequest

| Field | Type |
|---|---|
| `scope` | `string` |
| `page` | `int32` |
| `page_size` | `int32` |

### ListArtifactsResponse

| Field | Type |
|---|---|
| `artifacts` | repeated [`ArtifactRecord`](#artifactrecord) |
| `total_count` | `int32` |

### SetArtifactVisibilityRequest

| Field | Type |
|---|---|
| `id` | `string` |
| `visibility` | `string` |

### SetArtifactVisibilityResponse

| Field | Type |
|---|---|
| `artifact` | [`ArtifactRecord`](#artifactrecord) |
