---
title: "Set Attachment File Role"
method: PATCH
path: "/v1/attachments/{attachment_id}/file-role"
tags: ["attachments"]
---

# Set Attachment File Role

`PATCH /v1/attachments/{attachment_id}/file-role`

Designate an attachment's role. 'process_map' marks it as the resident
navigation map (rendered into the system prompt, never RAG'd); the offline
map builder uses this to promote a generated map file. Re-runs indexing so
role semantics apply immediately (a non-'reference' role is skipped by the
indexer, so a map never lands in the retrieval pool).

## Path parameters

- `attachment_id` string, required

## Request body

- FileRolePatch
  - `file_role` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)